@mongodb-js/mcp-types 2.1.1 → 3.0.0-prerelease.3

package/dist/sessionStore.d.ts

@@ -1,10 +1,27 @@
-import type { ILoggerBase } from "./logging.js";
-import type { IMetrics, MetricDefinitions } from "./metrics.js";
-import type { ISession } from "./session.js";
+import type { ClientCapabilities, Implementation } from "@modelcontextprotocol/server";
+import type { ILogger, ICompositeLogger } from "./logging.js";
+import type { IMetrics, DefaultMetricDefinitions } from "./metrics.js";
+/** @deprecated The per-client session concept is being removed; the 2025-era legacy path is the only remaining consumer. */
 export type CloseableTransport = {
     close(): Promise<void>;
 };
+/** @deprecated The per-client session concept is being removed; the 2025-era legacy path is the only remaining consumer. */
 export type SessionCloseReason = "idle_timeout" | "transport_closed" | "server_stop" | "unknown" | "evicted";
+/**
+ * The client state negotiated during MCP initialization. Stores that persist
+ * it durably allow an implicitly re-initialized session (one restored on a
+ * pod that never saw the client's `initialize` request) to retain the
+ * client's capabilities -- e.g. whether it supports elicitation -- instead of
+ * treating the restored client as capability-less.
+ *
+ * @deprecated The per-client session concept is being removed; the 2025-era
+ * legacy path is the only remaining consumer.
+ */
+export type NegotiatedClientState = {
+    clientCapabilities?: ClientCapabilities;
+    clientInfo?: Implementation;
+};
+/** @deprecated The per-client session concept is being removed; the 2025-era legacy path is the only remaining consumer. */
 export interface ISessionStore<T extends CloseableTransport = CloseableTransport> {
     /**
      * Returns the transport for the given session id or `undefined` if the
@@ -31,25 +48,42 @@ export interface ISessionStore<T extends CloseableTransport = CloseableTransport
     addSession(params: {
         sessionId: string;
         transport: T;
-        /** TODO: Remove in v2 — redundant with `session.logger`. */
-        logger: ILoggerBase;
-        session: ISession;
+        logger: ILogger;
+        session?: {
+            logger: ICompositeLogger;
+        };
         headers?: Record<string, unknown>;
     }): Promise<void>;
+    /** Returns whether a session exists, without resetting its idle timeout (unlike {@link getSession}). */
+    hasSession(sessionId: string): boolean;
     closeSession(params: {
         sessionId: string;
         reason?: SessionCloseReason;
     }): Promise<void>;
     closeAllSessions(): Promise<void>;
+    /**
+     * Durably records the client state negotiated during a real MCP
+     * initialization, so it can be restored when the session is later
+     * implicitly re-initialized (only relevant with
+     * `externallyManagedSessions`). Stores without durable storage can
+     * implement this as a no-op.
+     */
+    saveNegotiatedClientState(sessionId: string, state: NegotiatedClientState, headers?: Record<string, unknown>): Promise<void>;
+    /**
+     * Returns the previously saved negotiated client state for the session,
+     * or `undefined` when unknown.
+     */
+    loadNegotiatedClientState(sessionId: string, headers?: Record<string, unknown>): Promise<NegotiatedClientState | undefined>;
 }
-export type SessionStoreConstructorArgs<TMetrics extends MetricDefinitions = MetricDefinitions> = {
+/** @deprecated The per-client session concept is being removed; the 2025-era legacy path is the only remaining consumer. */
+export type SessionStoreConstructorArgs<TMetrics extends DefaultMetricDefinitions = DefaultMetricDefinitions> = {
     options: {
         idleTimeoutMS: number;
         notificationTimeoutMS: number;
         maxSessions: number;
         /**
          * When the store is at `maxSessions` and a new session arrives, evict the
-         * least-recently-used session instead of rejecting — but only if it has been
+         * least-recently-used session instead of rejecting -- but only if it has been
          * idle for at least this long (ms). Must be < `idleTimeoutMS` (the background
          * reaper already removes anything past that), or the valve never fires. If a
          * session idle >= this exists, it is closed locally to make room; otherwise
@@ -58,8 +92,7 @@ export type SessionStoreConstructorArgs<TMetrics extends MetricDefinitions = Met
          */
         evictionIdleGraceMS?: number;
     };
-    logger: ILoggerBase;
+    logger: ILogger;
     metrics: IMetrics<TMetrics>;
 };
-export type CreateSessionStoreFn<TTransport extends CloseableTransport = CloseableTransport, TMetrics extends MetricDefinitions = MetricDefinitions> = (args: SessionStoreConstructorArgs<TMetrics>) => ISessionStore<TTransport>;
 //# sourceMappingURL=sessionStore.d.ts.map

package/dist/sessionStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../src/sessionStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,kBAAkB,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7G,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB;IAC5E;;;;;;;;;;OAUG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACzF;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,CAAC,CAAC;QACb,4DAA4D;QAC5D,MAAM,EAAE,WAAW,CAAC;QACpB,OAAO,EAAE,QAAQ,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,YAAY,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,MAAM,MAAM,2BAA2B,CAAC,QAAQ,SAAS,iBAAiB,GAAG,iBAAiB,IAAI;IAC9F,OAAO,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,WAAW,EAAE,MAAM,CAAC;QACpB;;;;;;;;WAQG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,oBAAoB,CAC5B,UAAU,SAAS,kBAAkB,GAAG,kBAAkB,EAC1D,QAAQ,SAAS,iBAAiB,GAAG,iBAAiB,IACtD,CAAC,IAAI,EAAE,2BAA2B,CAAC,QAAQ,CAAC,KAAK,aAAa,CAAC,UAAU,CAAC,CAAC"}
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../src/sessionStore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACvF,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAEvE,4HAA4H;AAC5H,MAAM,MAAM,kBAAkB,GAAG;IAC7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,4HAA4H;AAC5H,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG,kBAAkB,GAAG,aAAa,GAAG,SAAS,GAAG,SAAS,CAAC;AAE7G;;;;;;;;;GASG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,UAAU,CAAC,EAAE,cAAc,CAAC;CAC/B,CAAC;AAEF,4HAA4H;AAC5H,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,kBAAkB,GAAG,kBAAkB;IAC5E;;;;;;;;;;OAUG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACzF;;;;;;;;;OASG;IACH,UAAU,CAAC,MAAM,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,CAAC,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE;YAAE,MAAM,EAAE,gBAAgB,CAAA;SAAE,CAAC;QACvC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClB,wGAAwG;IACxG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,YAAY,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,kBAAkB,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxF,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC;;;;;;OAMG;IACH,yBAAyB,CACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,qBAAqB,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB;;;OAGG;IACH,yBAAyB,CACrB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAAC;CACjD;AAED,4HAA4H;AAC5H,MAAM,MAAM,2BAA2B,CAAC,QAAQ,SAAS,wBAAwB,GAAG,wBAAwB,IAAI;IAC5G,OAAO,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,WAAW,EAAE,MAAM,CAAC;QACpB;;;;;;;;WAQG;QACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;CAC/B,CAAC"}

package/dist/telemetry.d.ts

@@ -8,4 +8,77 @@ export interface ITelemetry {
     emitEvents(events: unknown[]): void;
     close(): Promise<void>;
 }
+export type TelemetryResult = "success" | "failure";
+export type TelemetryBoolSet = "true" | "false";
+export type TelemetryCommonStaticProperties = {
+    mcp_server_version: string;
+    mcp_server_name: string;
+    platform: string;
+    arch: string;
+    os_type: string;
+    os_version?: string;
+};
+export type TelemetryCommonProperties = {
+    device_id?: string;
+    is_container_env?: TelemetryBoolSet;
+    mcp_client_version?: string;
+    mcp_client_name?: string;
+    transport?: "stdio" | "http";
+    config_atlas_auth?: TelemetryBoolSet;
+    config_connection_string?: TelemetryBoolSet;
+    hosting_mode?: string;
+    has_docker?: TelemetryBoolSet;
+} & TelemetryCommonStaticProperties;
+export type TelemetryEvent<T> = {
+    timestamp: string;
+    source: "mdbmcp";
+    properties: T & {
+        component: string;
+        duration_ms: number;
+        result: TelemetryResult;
+        category: string;
+    } & Record<string, string | number | string[]>;
+};
+export type TelemetryToolMetadataValue = string | number | boolean | undefined | string[];
+export type TelemetryToolMetadataBase = {
+    [key: string]: TelemetryToolMetadataValue;
+};
+export type AtlasMetadata = TelemetryToolMetadataBase & {
+    project_id?: string;
+    org_id?: string;
+};
+export type AtlasLocalToolMetadata = TelemetryToolMetadataBase & {
+    atlas_local_deployment_id?: string;
+};
+export type SharedTierTier = "Free" | "Flex";
+export declare const SHARED_TIER_METRIC_NAMES: readonly ["CONNECTIONS_PERCENT", "FLEX_CONNECTIONS_PERCENT", "FLEX_DATA_SIZE_TOTAL", "LOGICAL_SIZE"];
+export type SharedTierMetricName = (typeof SHARED_TIER_METRIC_NAMES)[number];
+export type ConnectionMetadata = AtlasMetadata & AtlasLocalToolMetadata & {
+    connection_auth_type?: string;
+    connection_host_type?: string;
+    /** Atlas cluster the connection points at, when it is an Atlas connection. */
+    cluster_name?: string;
+    cluster_id?: string;
+    shared_tier_alerts_detected?: TelemetryBoolSet;
+    shared_tier_tier?: SharedTierTier;
+    shared_tier_alerts?: SharedTierMetricName[];
+};
+export type PerfAdvisorToolMetadata = AtlasMetadata & ConnectionMetadata & {
+    operations: string[];
+};
+export type StreamsToolMetadata = AtlasMetadata & {
+    action?: string;
+    resource?: string;
+};
+export type IndexMetadata = ConnectionMetadata & {
+    index_type: "classic" | "vectorSearch" | "search";
+};
+export type TelemetryToolMetadata = AtlasMetadata | ConnectionMetadata | PerfAdvisorToolMetadata | StreamsToolMetadata | IndexMetadata;
+export type ToolEventProperties = {
+    command: string;
+    error_code?: string;
+    error_type?: string;
+    is_atlas?: boolean;
+} & TelemetryToolMetadata;
+export type ToolEvent = TelemetryEvent<ToolEventProperties>;
 //# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG;IAC1B,gBAAgB,EAAE,EAAE,CAAC;IACrB,oBAAoB,EAAE,EAAE,CAAC;IACzB,gBAAgB,EAAE,EAAE,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,UAAU;IACvB,kBAAkB,IAAI,OAAO,CAAC;IAC9B,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"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"}

package/dist/telemetry.js

@@ -1,2 +1,7 @@
-export {};
+export const SHARED_TIER_METRIC_NAMES = [
+    "CONNECTIONS_PERCENT",
+    "FLEX_CONNECTIONS_PERCENT",
+    "FLEX_DATA_SIZE_TOTAL",
+    "LOGICAL_SIZE",
+];
 //# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -1 +1 @@
-{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":""}
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAiEA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,qBAAqB;IACrB,0BAA0B;IAC1B,sBAAsB;IACtB,cAAc;CACR,CAAC"}

package/dist/tool.d.ts

@@ -1,11 +1,167 @@
+import type { CallToolResult, RequestMeta, ServerContext, McpServer } from "@modelcontextprotocol/server";
+export type { CallToolResult };
+import type { IToolConfig } from "./config.js";
+import type { ElicitationInputResponses, IElicitation } from "./elicitation.js";
+import type { ICompositeLogger } from "./logging.js";
+import type { IKeychain } from "./keychain.js";
+import type { DefaultMetricDefinitions, IMetrics } from "./metrics.js";
+import type { IUIRegistry } from "./ui.js";
+import type { ITelemetry } from "./telemetry.js";
+/**
+ * The services every tool receives at construction, injected individually
+ * (no server-scoped "session" object exists). The server is deliberately
+ * stateless: MongoDB connection state lives in the app-level registry and is
+ * addressed per request by `connectionId`, and per-client identity travels on
+ * the tool request (see `ToolExecutionContext.request.clientInfo`).
+ *
+ * Tool categories extend this type with the specific app-level services they
+ * need (e.g. the connection registry); `TConfig` narrows the configuration
+ * subset a category reads.
+ */
+export type ToolServices<TConfig extends IToolConfig = IToolConfig> = {
+    /** Configuration for the server */
+    readonly config: TConfig;
+    /** Logger for the server */
+    readonly logger: ICompositeLogger;
+    /** Redacts registered secrets from a value (used by ToolBase error handling). */
+    readonly keychain: IKeychain;
+};
+/**
+ * The service surface a tool reads from its server. Tool constructors receive
+ * exactly one argument — the server — which carries the individually-injected
+ * services ({@link ToolServices}) plus the shared infrastructure every tool
+ * needs (telemetry, elicitation, metrics and the UI registry). Category
+ * services (e.g. the connection registry) travel in `TServices`, so a server
+ * is structurally assignable to the `ToolServer` of each tool category it
+ * hosts.
+ */
+/**
+ * The minimal surface of a registered tool that a host reads off `server.tools`.
+ * Kept structural (rather than referencing {@link AnyToolBase} from mcp-core) to
+ * avoid a circular dependency: `@mongodb-js/mcp-types` is a base package.
+ */
+export type ToolServerTool = {
+    readonly name: string;
+    readonly category: ToolCategory;
+    readonly operationType: OperationType;
+    isEnabled(): boolean;
+};
+export type ToolServer<TServices extends ToolServices = ToolServices, TMetricsDefinitions extends DefaultMetricDefinitions = DefaultMetricDefinitions> = TServices & {
+    /** Telemetry for tracking tool usage. */
+    readonly telemetry: ITelemetry;
+    /** Elicitation for requesting user confirmation / input. */
+    readonly elicitation: IElicitation;
+    /** Metrics for tracking tool execution. */
+    readonly metrics: IMetrics<TMetricsDefinitions>;
+    /** UI registry for tools that embed interactive widget content. */
+    readonly uiRegistry?: IUIRegistry;
+    /** The SDK McpServer this tool is registered against. */
+    readonly mcpServer: McpServer;
+    /** The tools registered on this server (used to detect the export tool / list available tools). */
+    readonly tools: readonly ToolServerTool[];
+    /** Reports whether a tool category is enabled on this server. */
+    isToolCategoryAvailable(name: ToolCategory): boolean;
+};
+/**
+ * The type of operation the tool performs. This is used when evaluating if a tool is allowed to run based on
+ * the config's `disabledTools` and `readOnly` settings.
+ * - `metadata` is used for tools that read but do not access potentially user-generated
+ *   data, such as listing databases, collections, or indexes, or inferring collection schema.
+ * - `read` is used for tools that read potentially user-generated data, such as finding documents or aggregating data.
+ *   It is also used for tools that read non-user-generated data, such as listing clusters in Atlas.
+ * - `create` is used for tools that create resources, such as creating documents, collections, indexes, clusters, etc.
+ * - `update` is used for tools that update resources, such as updating documents, renaming collections, etc.
+ * - `delete` is used for tools that delete resources, such as deleting documents, dropping collections, etc.
+ * - `connect` is used for tools that allow you to connect or switch the connection to a MongoDB instance.
+ */
 export type OperationType = "metadata" | "read" | "create" | "delete" | "update" | "connect";
-export type ToolCategory = "mongodb" | "atlas" | "atlas-local" | "assistant";
-export type ToolExecutionContext = {
+/**
+ * The category of the tool. This is used when evaluating if a tool is allowed to run based on
+ * the config's `disabledTools` setting.
+ * - `mongodb` is used for tools that interact with a MongoDB instance, such as finding documents,
+ *   aggregating data, listing databases/collections/indexes, creating indexes, etc.
+ * - `atlas` is used for tools that interact with MongoDB Atlas, such as listing clusters, creating clusters, etc.
+ * - `atlas-local` is used for tools that interact with local Atlas deployments.
+ * - `assistant` is used for tools that interact with the Assistant, such as searching the public knowledge base.
+ * - `custom` is used for tools that are not part of the default tool categories.
+ */
+export type ToolCategory = "mongodb" | "atlas" | "atlas-local" | "assistant" | "custom";
+/**
+ * The request object passed to tool implementations: everything derived from
+ * the individual request being handled. It is built fresh for each tool call
+ * and deliberately lives nowhere else — the server holds no per-client or
+ * per-request state. The request-scoped server (and the effective,
+ * possibly request-overridden config it carries) is NOT on the request: tools
+ * read it off their construction-time `this.server` (the same instance). The
+ * per-request data (raw SDK request, signal, id, headers, client identity,
+ * ...) travels on the request itself (see `ToolExecutionContext.request`).
+ */
+export type ToolRequest<TConfig extends IToolConfig = IToolConfig> = {
+    /**
+     * The original request this request object was built around: the SDK's
+     * per-request `mcpReq` object the tool call handler received. Undefined
+     * when the tool is invoked directly in unit tests without a real SDK
+     * request. Prefer the normalized fields (`headers`, `id`, `clientInfo`,
+     * ...); reach for `raw` only when the typed surface does not cover what
+     * you need.
+     */
+    readonly raw?: ServerContext["mcpReq"];
+    /** AbortSignal for cancellation support */
     signal: AbortSignal;
-    requestInfo?: {
-        headers?: Record<string, unknown>;
+    /**
+     * HTTP request headers, available only when running atop
+     * StreamableHttpTransport. Used for request correlation (e.g.
+     * `x-request-id`) and forwarded to outgoing Atlas API requests.
+     */
+    headers?: Record<string, unknown>;
+    /** Metadata from the original MCP request (e.g. the client's progress token). */
+    _meta?: RequestMeta;
+    /** The request id, when invoked through an MCP server. */
+    id?: string | number;
+    /** Send an MCP server notification. */
+    sendNotification?: (notification: unknown) => Promise<void>;
+    /**
+     * Responses to a previous `input_required` round (protocol revision
+     * 2026-07-28 multi-round-trip requests). Present only when this request
+     * is a client retry carrying the answers to elicitation/sampling/roots
+     * requests the handler returned as `inputRequired(...)`. Keyed by the
+     * server-assigned identifiers of the embedded requests. Values are
+     * untrusted client input.
+     */
+    inputResponses?: ElicitationInputResponses;
+    /**
+     * Total time spent waiting for the user to answer elicitation requests
+     * raised while handling this call. Accumulated by
+     * `ToolBase.requestConfirmation` and subtracted from the tool execution
+     * duration metric, so that the user's think-time is not reported as
+     * time the tool spent working.
+     */
+    elicitationDurationMs?: number;
+    /**
+     * Identity of the MCP client that issued this request, as negotiated
+     * during initialization (or as declared on the request envelope in the
+     * 2026-07-28 protocol). Carried on the request — it is deliberately not
+     * stored on any server-scoped object, so the server holds no per-client
+     * state.
+     */
+    clientInfo?: {
+        name?: string;
+        version?: string;
+        title?: string;
     };
 };
+/**
+ * Request-scoped context provided during tool execution. The request object
+ * ({@link ToolRequest}) holds everything derived from the individual request
+ * — the request-scoped `server` (which carries the effective config), the
+ * original `raw` request, signal, request id, client identity, elicitation
+ * state — and is built fresh per call by `toToolExecutionContext`. Tools
+ * receive it as the `request` argument.
+ */
+export type ToolExecutionContext<TConfig extends IToolConfig = IToolConfig> = {
+    /** The request object this execution is built around. */
+    request: ToolRequest<TConfig>;
+};
 export type ToolClass<TParams extends unknown[] = unknown[]> = {
     new (params: TParams): {
         name: string;
@@ -16,6 +172,7 @@ export type ToolClass<TParams extends unknown[] = unknown[]> = {
     category: ToolCategory;
     operationType: OperationType;
 };
+export type AnyToolClass = ToolClass<any>;
 export interface IToolRegistrar {
     register(tool: ToolClass): boolean;
 }

package/dist/tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7F,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,CAAC;AAE7E,MAAM,MAAM,oBAAoB,GAAG;IAC/B,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,SAAS,CAAC,OAAO,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,IAAI;IAC3D,KAAK,MAAM,EAAE,OAAO,GAAG;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,YAAY,CAAC;QACvB,aAAa,EAAE,aAAa,CAAC;KAChC,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa,EAAE,aAAa,CAAC;CAChC,CAAC;AAEF,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;CACtC"}
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"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"}

package/dist/transport.d.ts

@@ -1,13 +1,49 @@
+/**
+ * Verified identity of an authenticated HTTP client (mirrors the SDK's
+ * `AuthInfo`). Carried on the request context so per-request servers can scope
+ * shared state (e.g. connections) by verified identity rather than
+ * self-asserted headers.
+ */
+export type RequestAuthInfo = {
+    /** The access token. */
+    token: string;
+    /** The client id associated with this token. */
+    clientId: string;
+    /** Scopes associated with this token. */
+    scopes: string[];
+    /** When the token expires (in seconds since epoch). */
+    expiresAt?: number;
+};
+/**
+ * The explicit authentication state of a request. Every HTTP request carries
+ * one or the other — there is no "unknown" — so per-request servers always
+ * know whether they are serving an authenticated client, and scope shared
+ * state (e.g. connections) by the verified `clientId` when authenticated.
+ * Identity is injected by the host (e.g. `req.auth` via the node adapter's
+ * pass-through, or directly on the request context); the server never
+ * authenticates on its own.
+ */
+export type RequestAuthState = {
+    mode: "unauthenticated";
+} | {
+    mode: "authenticated";
+    state: RequestAuthInfo;
+};
 export type TransportRequestContext = {
     headers?: Record<string, string | string[] | undefined>;
     query?: Record<string, string | string[] | undefined>;
+    /**
+     * The explicit auth state of this request. When authenticated, shared state
+     * (connections) is scoped by `state.clientId`; unauthenticated requests are
+     * isolated from authenticated clients.
+     */
+    authInfo?: RequestAuthState;
 };
 export interface ITransportRunner {
     start(options: {
         serverOptions?: unknown;
         sessionOptions?: unknown;
     }): Promise<void>;
-    closeTransport(): Promise<void>;
     close(): Promise<void>;
 }
 export interface IServerFactory {

package/dist/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,uBAAuB,GAAG;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACzD,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,OAAO,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC3B,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC1B,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,yCAAyC;IACzC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAE,IAAI,EAAE,iBAAiB,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,CAAC;AAE/G,MAAM,MAAM,uBAAuB,GAAG;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACtD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC/B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC7B,KAAK,CAAC,OAAO,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAC;QAAC,cAAc,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC3B,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD"}

package/dist/transports.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Options for configuring the HTTP server (host, port, etc).
+ */
+export type HttpServerOptions = {
+    /** Host to bind the HTTP server to */
+    host: string;
+    /** Port to bind the HTTP server to */
+    port: number;
+    /** Maximum HTTP body size in bytes */
+    bodyLimit?: number;
+    /** Headers to validate */
+    headers?: Record<string, string>;
+    /** Response type: 'sse' for Server-Sent Events, 'json' for JSON responses */
+    responseType?: "sse" | "json";
+    /**
+     * The HTTP entry's auth mode (required — there is no implicit default so a
+     * deployment's posture is always explicit):
+     *
+     * - `"authenticated"`: every request must carry a verified identity (hosts
+     *   inject it via `req.auth`, which the node adapter forwards as the
+     *   handler's authInfo; the server never authenticates on its own).
+     *   Unauthenticated requests are rejected with 401 and the request
+     *   context's authInfo is always `{ mode: "authenticated", state }`.
+     * - `"unauthenticated"`: authInfo carries whatever the host provides,
+     *   defaulting to `{ mode: "unauthenticated" }`.
+     */
+    authMode: "authenticated" | "unauthenticated";
+};
+/**
+ * Options for transport runners.
+ */
+export type TransportRunnerOptions = {
+    /** Server name */
+    name: string;
+    /** Server version */
+    version: string;
+};
+//# sourceMappingURL=transports.d.ts.map

package/dist/transports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.d.ts","sourceRoot":"","sources":["../src/transports.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC5B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,eAAe,GAAG,iBAAiB,CAAC;CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACjC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/transports.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=transports.js.map

package/dist/transports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transports.js","sourceRoot":"","sources":["../src/transports.ts"],"names":[],"mappings":""}

package/dist/ui.d.ts

@@ -1,6 +1,30 @@
-export type UIRegistryOptions = {
+export interface UIRegistryOptions {
+    /**
+     * Custom UIs for tools. Function that returns HTML strings for tool names.
+     * Use this to add UIs to tools or replace the default bundled UIs.
+     * The function is called lazily when a UI is requested, allowing you to
+     * defer loading large HTML files until needed.
+     *
+     * ```ts
+     * import { readFileSync } from 'fs';
+     * const server = new Server({
+     *     // ... other options
+     *     customUIs: (toolName) => {
+     *         if (toolName === 'list-databases') {
+     *             return readFileSync('./my-custom-ui.html', 'utf-8');
+     *         }
+     *         return null;
+     *     }
+     * });
+     * ```
+     */
     customUIs?: (toolName: string) => string | null | Promise<string | null>;
-};
+    /**
+     * Lazy loaders for bundled UI HTML strings, keyed by tool name.
+     * Each loader returns a Promise that resolves to the HTML string.
+     */
+    loaders?: Record<string, (() => Promise<string>) | undefined>;
+}
 export interface IUIRegistry {
     get(toolName: string): Promise<string | null>;
 }

package/dist/ui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC5B,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC5E,CAAC;AAEF,MAAM,WAAW,WAAW;IACxB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjD"}
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../src/ui.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAC9B;;;;;;;;;;;;;;;;;;OAkBG;IACH,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEzE;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,WAAW;IACxB,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mongodb-js/mcp-types",
   "description": "Shared TypeScript types and interfaces for MongoDB MCP server packages",
-  "version": "2.1.1",
+  "version": "3.0.0-prerelease.3",
   "type": "module",
   "license": "Apache-2.0",
   "author": "MongoDB <info@mongodb.com>",
@@ -18,19 +18,22 @@
       "default": "./dist/index.js"
     }
   },
-  "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.0.0",
+    "mongodb-redact": "^1.4.6"
+  },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "mongodb-log-writer": "^2.5.13",
     "typescript": "^5.9.2",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "scripts": {
-    "compile": "tsc --project tsconfig.json",
-    "test": "vitest --run"
+    "build": "tsc --build tsconfig.build.json",
+    "test": "vitest --run",
+    "check": "tsc --noEmit --project tsconfig.json"
   }
 }

package/dist/session.d.ts

@@ -1,30 +0,0 @@
-import type { ICompositeLogger } from "./logging.js";
-export type SessionEvents = {
-    connect: [];
-    close: [];
-    disconnect: [];
-    "connection-error": [unknown];
-};
-export interface ISession {
-    readonly sessionId: string;
-    logger: ICompositeLogger;
-    mcpClient?: {
-        name?: string;
-        version?: string;
-        title?: string;
-    };
-    /** TODO: Consider removing if possible */
-    setMcpClient(mcpClient: {
-        name?: string;
-        version?: string;
-        title?: string;
-    } | undefined): void;
-    disconnect(): Promise<void>;
-    close(): Promise<void>;
-    readonly isConnectedToMongoDB: boolean;
-    on<K extends keyof SessionEvents>(options: {
-        event: K;
-        listener: (...args: SessionEvents[K]) => void;
-    }): this;
-}
-//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD,MAAM,MAAM,aAAa,GAAG;IACxB,OAAO,EAAE,EAAE,CAAC;IACZ,KAAK,EAAE,EAAE,CAAC;IACV,UAAU,EAAE,EAAE,CAAC;IACf,kBAAkB,EAAE,CAAC,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,gBAAgB,CAAC;IACzB,SAAS,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,0CAA0C;IAC1C,YAAY,CAAC,SAAS,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/F,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,CAAC,CAAC;QAAC,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACjH"}

package/dist/session.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=session.js.map

package/dist/session.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"session.js","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":""}