@mongodb-js/mcp-types 2.1.0 → 3.0.0-prerelease.2

package/dist/apiClient.d.ts

@@ -1,20 +1,10 @@
-export interface IApiClient<TEvent extends unknown[] = unknown[]> {
+import type { TelemetryCommonProperties, TelemetryEvent } from "./telemetry.js";
+export interface IApiClient<TEvent extends unknown[] = TelemetryEvent<TelemetryCommonProperties>[]> {
     isAuthConfigured(): boolean;
     close(): Promise<void>;
-    sendEvents(options?: {
+    validateAuthConfig(): Promise<void>;
+    sendEvents(events: TEvent, options?: {
         signal?: AbortSignal;
-        events: TEvent;
     }): Promise<void>;
 }
-export type ApiClientOptions = {
-    baseUrl: string;
-    userAgent?: string;
-    credentials?: {
-        clientId: string;
-        clientSecret: string;
-    };
-    requestContext?: {
-        headers?: Record<string, string | string[] | undefined>;
-    };
-};
 //# sourceMappingURL=apiClient.d.ts.map

package/dist/apiClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../src/apiClient.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE;IAC5D,gBAAgB,IAAI,OAAO,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,cAAc,CAAC,EAAE;QACb,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;KAC3D,CAAC;CACL,CAAC"}
+{"version":3,"file":"apiClient.d.ts","sourceRoot":"","sources":["../src/apiClient.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhF,MAAM,WAAW,UAAU,CAAC,MAAM,SAAS,OAAO,EAAE,GAAG,cAAc,CAAC,yBAAyB,CAAC,EAAE;IAC9F,gBAAgB,IAAI,OAAO,CAAC;IAC5B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjF"}

package/dist/config.d.ts

@@ -0,0 +1,20 @@
+import type { PreviewFeature } from "./schemas.js";
+export type TransportType = "stdio" | "http";
+export interface IToolConfig {
+    transport: TransportType;
+    httpBodyLimit?: number;
+    httpResponseType: "sse" | "json";
+    readOnly: boolean;
+    disabledTools: string[];
+    confirmationRequiredTools: string[];
+    previewFeatures: PreviewFeature[];
+}
+/** Server metadata for the server. */
+export type ServerMetadata = {
+    version: string;
+    mcpServerName: string;
+    engines?: {
+        node: string;
+    };
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAE7C,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,aAAa,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,KAAK,GAAG,MAAM,CAAC;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,yBAAyB,EAAE,MAAM,EAAE,CAAC;IACpC,eAAe,EAAE,cAAc,EAAE,CAAC;CACrC;AAED,sCAAsC;AACtC,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B,CAAC"}

package/dist/config.js

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

package/dist/config.js.map

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

package/dist/connection.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Atlas cluster connection info containing details about the connected Atlas cluster.
+ * When provided, indicates the connection is to an Atlas cluster.
+ */
+export type AtlasClusterConnectionInfo = {
+    username: string;
+    projectId: string;
+    clusterName: string;
+    instanceType: "FREE" | "FLEX" | "DEDICATED";
+    provider?: string;
+    region?: string;
+    expiryDate: Date;
+};
+/**
+ * Connection string info describing the auth and host type of a MongoDB connection.
+ */
+export type ConnectionStringInfo = {
+    authType: "scram" | "ldap" | "kerberos" | "oidc-auth-flow" | "oidc-device-flow" | "x.509" | "unknown";
+    hostType: "unknown" | "atlas" | "local" | "atlas_local" | "other";
+};
+/**
+ * Structural subset of a MongoDB connection's state used by tool telemetry
+ * (kept dependency-free in mcp-types so core can describe it without
+ * importing the tools-mongodb connection model).
+ */
+export type SupportedConnectionState = {
+    tag: string;
+    connectionStringInfo?: ConnectionStringInfo;
+    connectedAtlasCluster?: AtlasClusterConnectionInfo;
+};
+//# sourceMappingURL=connection.d.ts.map

package/dist/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../src/connection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,OAAO,GAAG,SAAS,CAAC;IACtG,QAAQ,EAAE,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,OAAO,CAAC;CACrE,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,qBAAqB,CAAC,EAAE,0BAA0B,CAAC;CACtD,CAAC"}

package/dist/connection.js

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

package/dist/connection.js.map

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

package/dist/elicitation.d.ts

@@ -1,3 +1,4 @@
+import type { ElicitRequestFormParams, ProgressToken, RequestId, ServerNotification } from "@modelcontextprotocol/sdk/types.js";
 export type ElicitedInputResult = {
     accepted: true;
     fields: Record<string, string>;
@@ -5,12 +6,21 @@ export type ElicitedInputResult = {
     accepted: false;
     fields?: undefined;
 };
+/** The schema accepted by {@link IElicitation.requestInput}. */
+export type ElicitRequestSchema = ElicitRequestFormParams["requestedSchema"];
+export type ElicitationOptions = {
+    /** The id of the in-flight client request this elicitation belongs to. */
+    relatedRequestId?: RequestId;
+    /** The progress token supplied by the client on the in-flight request. */
+    progressToken?: ProgressToken;
+    /** Sends a notification related to the in-flight request. */
+    sendNotification?: (notification: ServerNotification) => Promise<void>;
+    /** The abort signal of the in-flight request. */
+    signal?: AbortSignal;
+};
 export interface IElicitation {
     supportsElicitation(): boolean;
-    requestConfirmation(message: string): Promise<boolean>;
-    requestInput(options: {
-        message: string;
-        schema: unknown;
-    }): Promise<ElicitedInputResult>;
+    requestConfirmation(message: string, options?: ElicitationOptions): Promise<boolean>;
+    requestInput(message: string, schema: ElicitRequestSchema, options?: ElicitationOptions): Promise<ElicitedInputResult>;
 }
 //# sourceMappingURL=elicitation.d.ts.map

package/dist/elicitation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GACzB;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClD;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE9C,MAAM,WAAW,YAAY;IACzB,mBAAmB,IAAI,OAAO,CAAC;IAC/B,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,YAAY,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;CAC7F"}
+{"version":3,"file":"elicitation.d.ts","sourceRoot":"","sources":["../src/elicitation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,uBAAuB,EACvB,aAAa,EACb,SAAS,EACT,kBAAkB,EACrB,MAAM,oCAAoC,CAAC;AAE5C,MAAM,MAAM,mBAAmB,GACzB;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAClD;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC;AAE9C,gEAAgE;AAChE,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,CAAC,iBAAiB,CAAC,CAAC;AAE7E,MAAM,MAAM,kBAAkB,GAAG;IAC7B,0EAA0E;IAC1E,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvE,iDAAiD;IACjD,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,YAAY;IACzB,mBAAmB,IAAI,OAAO,CAAC;IAC/B,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrF,YAAY,CACR,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,kBAAkB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACnC"}

package/dist/index.d.ts

@@ -1,14 +1,20 @@
+export type * from "./config.js";
+export type { AtlasClusterConnectionInfo, ConnectionStringInfo, SupportedConnectionState } from "./connection.js";
+export type * from "./schemas.js";
 export type * from "./session.js";
 export type * from "./sessionStore.js";
+export type * from "./transports.js";
 export type * from "./keychain.js";
 export type * from "./elicitation.js";
 export type * from "./logging.js";
 export type * from "./tool.js";
 export type * from "./transport.js";
 export type * from "./apiClient.js";
-export type * from "./metrics.js";
+export type { IObservable, ICounter, IGauge, DefaultMetricDefinitions, IMetrics } from "./metrics.js";
 export type * from "./ui.js";
 export type * from "./resources.js";
 export type * from "./telemetry.js";
+export { SHARED_TIER_METRIC_NAMES } from "./telemetry.js";
 export type * from "./helpers.js";
+export type * from "./server.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,SAAS,CAAC;AAC7B,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,aAAa,CAAC;AACjC,YAAY,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAClH,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,mBAAmB,CAAC;AACvC,mBAAmB,iBAAiB,CAAC;AACrC,mBAAmB,eAAe,CAAC;AACnC,mBAAmB,kBAAkB,CAAC;AACtC,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,WAAW,CAAC;AAC/B,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,gBAAgB,CAAC;AACpC,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,wBAAwB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACtG,mBAAmB,SAAS,CAAC;AAC7B,mBAAmB,gBAAgB,CAAC;AACpC,mBAAmB,gBAAgB,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC1D,mBAAmB,cAAc,CAAC;AAClC,mBAAmB,aAAa,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export {};
+export { SHARED_TIER_METRIC_NAMES } from "./telemetry.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/keychain.d.ts

@@ -1,9 +1,10 @@
-export interface IKeychain {
-    register(options: {
-        value: unknown;
-        kind: string;
-    }): void;
+import type { Secret } from "mongodb-redact";
+export interface IKeychain<TKey = Secret["value"], TKind = Secret["kind"]> {
+    register(value: unknown, kind: string): void;
     clearAllSecrets(): void;
-    readonly allSecrets: unknown[];
+    readonly allSecrets: {
+        value: TKey;
+        kind: TKind;
+    }[];
 }
 //# sourceMappingURL=keychain.d.ts.map

package/dist/keychain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keychain.d.ts","sourceRoot":"","sources":["../src/keychain.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1D,eAAe,IAAI,IAAI,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,EAAE,CAAC;CAClC"}
+{"version":3,"file":"keychain.d.ts","sourceRoot":"","sources":["../src/keychain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,MAAM,WAAW,SAAS,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;IACrE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,eAAe,IAAI,IAAI,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE;QAAE,KAAK,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,KAAK,CAAA;KAAE,EAAE,CAAC;CACvD"}

package/dist/logging.d.ts

@@ -1,8 +1,18 @@
-import type { MongoLogId } from "mongodb-log-writer";
-export type LogLevel = "debug" | "info" | "notice" | "warning" | "error" | "critical" | "alert" | "emergency";
+import type { LoggingMessageNotification } from "@modelcontextprotocol/sdk/types.js";
+import type { IKeychain } from "./keychain.js";
+export type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export type LogLevel = LoggingMessageNotification["params"]["level"];
 export type LoggerType = "console" | "disk" | "mcp";
 export type EventMap<T> = Record<keyof T, any[]>;
 export type DefaultEventMap = Record<string, never[]>;
+export type MongoDBLogLevel = "info" | "warn" | "error" | "debug" | "fatal";
+export type LogWriteFunction = (component: string, id: MongoLogId, context: string, message: string, attr?: unknown) => void;
+export type LogWriter = Record<MongoDBLogLevel, LogWriteFunction> & {
+    flush(): Promise<void>;
+};
+export type MongoLogId = {
+    __value: number;
+};
 export type LogPayload = {
     id: MongoLogId;
     context: string;
@@ -10,11 +20,8 @@ export type LogPayload = {
     noRedaction?: boolean | LoggerType | LoggerType[];
     attributes?: Record<string, string>;
 };
-export interface ILoggerBase {
-    log(options: {
-        level: LogLevel;
-        payload: LogPayload;
-    }): void;
+export interface ILogger {
+    log(level: LogLevel, payload: LogPayload): void;
     info(payload: LogPayload): void;
     error(payload: LogPayload): void;
     debug(payload: LogPayload): void;
@@ -23,12 +30,13 @@ export interface ILoggerBase {
     critical(payload: LogPayload): void;
     alert(payload: LogPayload): void;
     emergency(payload: LogPayload): void;
+    flush(): Promise<PromiseSettledResult<void>[]>;
 }
-export interface ICompositeLogger extends ILoggerBase {
-    addLogger(logger: ILoggerBase): void;
-    setAttribute(options: {
-        key: string;
-        value: string;
-    }): void;
+export type LoggerConfig = {
+    keychain: IKeychain;
+};
+export interface ICompositeLogger extends ILogger {
+    addLogger(logger: ILogger): void;
+    setAttribute(key: string, value: string): void;
 }
 //# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,GAAG,OAAO,GAAG,WAAW,CAAC;AAE9G,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;AAGpD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAEtD,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,UAAU,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,EAAE,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,WAAW,WAAW;IACxB,GAAG,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,QAAQ,CAAC;QAAC,OAAO,EAAE,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7D,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACjD,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IACrC,YAAY,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC/D"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AACrF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C,YAAY,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,MAAM,MAAM,QAAQ,GAAG,0BAA0B,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC;AAErE,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,KAAK,CAAC;AAGpD,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;AAEjD,MAAM,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AAEtD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5E,MAAM,MAAM,gBAAgB,GAAG,CAC3B,SAAS,EAAE,MAAM,EACjB,EAAE,EAAE,UAAU,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,OAAO,KACb,IAAI,CAAC;AAEV,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,EAAE,gBAAgB,CAAC,GAAG;IAChE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACrB,EAAE,EAAE,UAAU,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,EAAE,CAAC;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,MAAM,WAAW,OAAO;IACpB,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,OAAO,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,SAAS,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACrC,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;CAClD;AAED,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF,MAAM,WAAW,gBAAiB,SAAQ,OAAO;IAC7C,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CAClD"}

package/dist/metrics.d.ts

@@ -1,8 +1,61 @@
-export type MetricDefinitions = {
-    [key: string]: unknown;
+/**
+ * Labels type for metrics.
+ */
+export type MetricLabels = Partial<Record<string, string | number>>;
+/**
+ * Interface for observable metrics (like histograms).
+ * Used for recording values that can be observed over time.
+ */
+export interface IObservable {
+    observe(labels: MetricLabels, value: number): void;
+}
+/**
+ * Interface for counter metrics.
+ * Used for counting events, can be incremented.
+ */
+export interface ICounter {
+    inc(labels?: MetricLabels, value?: number): void;
+}
+/**
+ * Interface for gauge metrics.
+ * Used for metrics that can go up and down (e.g. currently active sessions).
+ */
+export interface IGauge {
+    set(value: number): void;
+    inc(labels?: MetricLabels, value?: number): void;
+    dec(labels?: MetricLabels, value?: number): void;
+}
+/**
+ * Default metric definitions for MCP servers.
+ * These are the standard metrics used across the MCP packages.
+ *
+ * @example
+ * ```typescript
+ * // Usage with session store
+ * const store = new SessionStore({
+ *   metrics: myMetrics,
+ *   ...
+ * });
+ * ```
+ */
+export type DefaultMetricDefinitions = {
+    /** Counter for tracking created sessions */
+    sessionCreated: ICounter;
+    /** Counter for tracking closed sessions with reason label */
+    sessionClosed: ICounter;
+    /** Histogram for tracking tool execution duration in seconds */
+    toolExecutionDuration: IObservable;
+    /** Gauge for tracking currently active sessions */
+    sessionsActive: IGauge;
 };
-export interface IMetrics<TMetrics extends MetricDefinitions = MetricDefinitions> {
-    get<K extends keyof TMetrics>(key: K): TMetrics[K];
+/**
+ * Interface for accessing metrics.
+ * @template TMetricsDefinitions - The type of metric definitions this metrics instance uses
+ */
+export interface IMetrics<TMetricsDefinitions extends DefaultMetricDefinitions = DefaultMetricDefinitions> {
+    /** Get a specific metric by name */
+    get<K extends keyof TMetricsDefinitions>(key: K): TMetricsDefinitions[K];
+    /** Get all metrics as a formatted string (e.g., Prometheus format) */
     getMetrics(): Promise<string>;
 }
 //# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,QAAQ,CAAC,QAAQ,SAAS,iBAAiB,GAAG,iBAAiB;IAC5E,GAAG,CAAC,CAAC,SAAS,MAAM,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnD,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;AAEpE;;;GAGG;AACH,MAAM,WAAW,WAAW;IACxB,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtD;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,GAAG,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpD;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACnB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,GAAG,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpD;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,4CAA4C;IAC5C,cAAc,EAAE,QAAQ,CAAC;IACzB,6DAA6D;IAC7D,aAAa,EAAE,QAAQ,CAAC;IACxB,gEAAgE;IAChE,qBAAqB,EAAE,WAAW,CAAC;IACnC,mDAAmD;IACnD,cAAc,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,QAAQ,CAAC,mBAAmB,SAAS,wBAAwB,GAAG,wBAAwB;IACrG,oCAAoC;IACpC,GAAG,CAAC,CAAC,SAAS,MAAM,mBAAmB,EAAE,GAAG,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;IACzE,sEAAsE;IACtE,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CACjC"}

package/dist/resources.d.ts

@@ -1,5 +1,54 @@
+import type { ResourceMetadata, ReadResourceCallback } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionEvents } from "./session.js";
+import type { ITelemetry } from "./telemetry.js";
+import type { IToolConfig } from "./config.js";
+import type { ICompositeLogger } from "./logging.js";
+/**
+ * The minimal session surface resources may rely on. The CLI's session is
+ * deliberately stateless (connection state lives in the app-level registry),
+ * so resources are not constrained to the full {@link ISession} shape.
+ */
+export interface IResourceSession {
+    readonly config: IToolConfig;
+    readonly logger: ICompositeLogger;
+    on(event: keyof SessionEvents, listener: (...args: unknown[]) => void): void;
+}
 export interface IResource {
     register(server: unknown): void;
 }
 export type IResources = readonly IResource[];
+/** Static resource metadata (name/uri/description). Mirrors `resourceConfiguration` from v2-move. */
+export type ResourceConfiguration = {
+    name: string;
+    uri: string;
+    config: ResourceMetadata;
+};
+export type ReactiveResourceOptions<Value, RelevantEvents extends readonly (keyof SessionEvents)[]> = {
+    initial: Value;
+    events: RelevantEvents;
+};
+/** The host server surface resources register against. */
+export interface IResourceServer {
+    mcpServer: {
+        registerResource: (name: string, uri: string, config: ResourceMetadata, callback: ReadResourceCallback) => void;
+    };
+    sendResourceListChanged(): void;
+    sendResourceUpdated(uri: string): void;
+}
+/**
+ * The type that all resource classes must conform to when implementing custom resources
+ * for the MongoDB MCP Server.
+ *
+ * This type enforces that resource classes have a constructor accepting
+ * `(session, telemetry)`, matching the construction pattern used by
+ * {@link CliServer} (see `registerResources`). The resolved user
+ * configuration is read from `session.config`.
+ */
+export type ResourceClass<TSession extends IResourceSession = IResourceSession> = {
+    new (session: TSession, telemetry: ITelemetry): {
+        register(server: IResourceServer): void;
+    };
+};
+/** Resource constructor type for registries that may include session-specific resource implementations. */
+export type AnyResourceClass = ResourceClass<any>;
 //# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,SAAS,EAAE,CAAC"}
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACtG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,EAAE,CAAC,KAAK,EAAE,MAAM,aAAa,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CAChF;AAED,MAAM,WAAW,SAAS;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,SAAS,EAAE,CAAC;AAE9C,qGAAqG;AACrG,MAAM,MAAM,qBAAqB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,gBAAgB,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,KAAK,EAAE,cAAc,SAAS,SAAS,CAAC,MAAM,aAAa,CAAC,EAAE,IAAI;IAClG,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;CAC1B,CAAC;AAEF,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE;QACP,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,oBAAoB,KAAK,IAAI,CAAC;KACnH,CAAC;IACF,uBAAuB,IAAI,IAAI,CAAC;IAChC,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,QAAQ,SAAS,gBAAgB,GAAG,gBAAgB,IAAI;IAC9E,KAAK,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,GAAG;QAAE,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;KAAE,CAAC;CAC/F,CAAC;AAEF,2GAA2G;AAE3G,MAAM,MAAM,gBAAgB,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,2 @@
+export type PreviewFeature = "mcpUI";
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/dist/schemas.js

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

package/dist/schemas.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,35 @@
+import type { Transport } from "@modelcontextprotocol/sdk/shared/transport";
+import type { ClientCapabilities, Implementation } from "@modelcontextprotocol/sdk/types.js";
+import type { ICompositeLogger } from "./logging.js";
+/**
+ * Minimum server interface required by MCPHttpServer.
+ * Servers must have connect/close methods, a session with a logger (and a
+ * `setMcpClient` hook) for HTTP transport functionality, and expose the
+ * protocol-level MCP server so negotiated client state can be captured and
+ * restored across implicit re-initializations.
+ */
+export type SessionServer<TTransport extends Transport = Transport> = {
+    connect(transport: TTransport): Promise<void>;
+    close(): Promise<void>;
+    session: {
+        logger: ICompositeLogger;
+        /**
+         * Records the MCP client that negotiated this session's
+         * initialization. Required to restore negotiated client state on
+         * implicitly re-initialized sessions.
+         */
+        setMcpClient(mcpClient: unknown): void;
+    };
+    /**
+     * The protocol-level MCP server, required to capture/restore negotiated
+     * client state across implicit re-initializations.
+     */
+    mcpServer: {
+        server: {
+            oninitialized?: (() => void) | undefined;
+            getClientCapabilities(): ClientCapabilities | undefined;
+            getClientVersion(): Implementation | undefined;
+        };
+    };
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4CAA4C,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,CAAC,UAAU,SAAS,SAAS,GAAG,SAAS,IAAI;IAClE,OAAO,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,OAAO,EAAE;QACL,MAAM,EAAE,gBAAgB,CAAC;QACzB;;;;WAIG;QACH,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;KAC1C,CAAC;IACF;;;OAGG;IACH,SAAS,EAAE;QACP,MAAM,EAAE;YACJ,aAAa,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;YACzC,qBAAqB,IAAI,kBAAkB,GAAG,SAAS,CAAC;YACxD,gBAAgB,IAAI,cAAc,GAAG,SAAS,CAAC;SAClD,CAAC;KACL,CAAC;CACL,CAAC"}

package/dist/server.js

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

package/dist/server.js.map

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

package/dist/session.d.ts

@@ -1,11 +1,13 @@
 import type { ICompositeLogger } from "./logging.js";
+import type { IKeychain } from "./keychain.js";
+import type { IToolConfig } from "./config.js";
 export type SessionEvents = {
     connect: [];
     close: [];
     disconnect: [];
     "connection-error": [unknown];
 };
-export interface ISession {
+export interface ISession<TConfig extends IToolConfig = IToolConfig> {
     readonly sessionId: string;
     logger: ICompositeLogger;
     mcpClient?: {
@@ -22,9 +24,21 @@ export interface ISession {
     disconnect(): Promise<void>;
     close(): Promise<void>;
     readonly isConnectedToMongoDB: boolean;
-    on<K extends keyof SessionEvents>(options: {
-        event: K;
-        listener: (...args: SessionEvents[K]) => void;
-    }): this;
+    /** Event emitter method for reactive resources */
+    on(event: "connect" | "disconnect" | "close" | "connection-error", listener: (...args: unknown[]) => void): void;
+    /** Keychain for secret management */
+    readonly keychain: IKeychain;
+    /** Configuration for the session */
+    readonly config: TConfig;
+    /** Optional connection string info */
+    readonly connectionStringInfo?: {
+        authType?: string;
+        hostType?: string;
+    };
+    /** Optional connected Atlas cluster info */
+    readonly connectedAtlasCluster?: {
+        projectId?: string;
+        clusterName?: string;
+    };
 }
 //# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,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,CAAC,OAAO,SAAS,WAAW,GAAG,WAAW;IAC/D,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,kDAAkD;IAClD,EAAE,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,OAAO,GAAG,kBAAkB,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IACjH,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,QAAQ,CAAC,oBAAoB,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,4CAA4C;IAC5C,QAAQ,CAAC,qBAAqB,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjF"}

package/dist/sessionStore.d.ts

@@ -1,10 +1,21 @@
-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/sdk/types.js";
+import type { ILogger, ICompositeLogger } from "./logging.js";
+import type { IMetrics, DefaultMetricDefinitions } from "./metrics.js";
 export type CloseableTransport = {
     close(): Promise<void>;
 };
 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.
+ */
+export type NegotiatedClientState = {
+    clientCapabilities?: ClientCapabilities;
+    clientInfo?: Implementation;
+};
 export interface ISessionStore<T extends CloseableTransport = CloseableTransport> {
     /**
      * Returns the transport for the given session id or `undefined` if the
@@ -31,9 +42,10 @@ 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>;
     closeSession(params: {
@@ -41,15 +53,28 @@ export interface ISessionStore<T extends CloseableTransport = CloseableTransport
         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> = {
+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 +83,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,oCAAoC,CAAC;AAC7F,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAEvE,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;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAChC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,UAAU,CAAC,EAAE,cAAc,CAAC;CAC/B,CAAC;AAEF,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,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,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,75 @@ 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;
+    session_id?: string;
+    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;
+    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":"AAkEA,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACpC,qBAAqB;IACrB,0BAA0B;IAC1B,sBAAsB;IACtB,cAAc;CACR,CAAC"}

package/dist/tool.d.ts

@@ -1,10 +1,73 @@
+import { type CallToolResult, type RequestMeta } from "@modelcontextprotocol/sdk/types.js";
+export type { CallToolResult };
+import type { Secret } from "mongodb-redact";
+import type { IToolConfig } from "./config.js";
+import type { ICompositeLogger } from "./logging.js";
+/**
+ * The minimal session surface tools rely on: config and logging. The CLI's
+ * session is deliberately stateless (connection state lives in the app-level
+ * registry and is addressed by connectionId), so tools are not constrained to
+ * the full {@link ISession} shape.
+ */
+export interface IToolSession {
+    readonly config: IToolConfig;
+    readonly logger: ICompositeLogger;
+    /** Secrets registered for redaction (used by ToolBase error handling). */
+    readonly keychain: {
+        readonly allSecrets: Secret[];
+    };
+}
+/**
+ * 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";
+/**
+ * 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";
+/**
+ * Context provided during tool execution.
+ */
 export type ToolExecutionContext = {
+    /** AbortSignal for cancellation support */
     signal: AbortSignal;
+    /**
+     * Request context object available only when running atop
+     * StreamableHttpTransport.
+     */
     requestInfo?: {
         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. */
+    requestId?: string | number;
+    /** Send an MCP server notification. */
+    sendNotification?: (notification: unknown) => Promise<void>;
+    /**
+     * 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;
 };
 export type ToolClass<TParams extends unknown[] = unknown[]> = {
     new (params: TParams): {
@@ -16,6 +79,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":"AAAA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAC3F,YAAY,EAAE,cAAc,EAAE,CAAC;AAC/B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACxD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7F;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAC/B,2CAA2C;IAC3C,MAAM,EAAE,WAAW,CAAC;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACrC,CAAC;IACF,iFAAiF;IACjF,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,uCAAuC;IACvC,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAClC,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;AAGF,MAAM,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;CACtC"}

package/dist/transport.d.ts

@@ -7,7 +7,6 @@ export interface ITransportRunner {
         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,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,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,36 @@
+/**
+ * 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";
+};
+/**
+ * Options for session management.
+ */
+export type SessionManagementOptions = {
+    /** Idle timeout in milliseconds */
+    idleTimeoutMs: number;
+    /** Notification timeout in milliseconds */
+    notificationTimeoutMs: number;
+    /** Whether to allow externally managed sessions */
+    externallyManagedSessions: boolean;
+};
+/**
+ * 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;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACnC,mCAAmC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,yBAAyB,EAAE,OAAO,CAAC;CACtC,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.0",
+  "version": "3.0.0-prerelease.2",
   "type": "module",
   "license": "Apache-2.0",
   "author": "MongoDB <info@mongodb.com>",
@@ -18,19 +18,20 @@
       "default": "./dist/index.js"
     }
   },
-  "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist"
   ],
   "devDependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "mongodb-redact": "^1.4.6",
     "@types/node": "^25.6.0",
-    "mongodb-log-writer": "^2.5.13",
     "typescript": "^5.9.2",
     "vitest": "^4.1.10"
   },
   "scripts": {
-    "compile": "tsc --project tsconfig.json",
-    "test": "vitest --run"
+    "build": "tsc --build tsconfig.build.json",
+    "test": "vitest --run",
+    "check": "tsc --build tsconfig.build.json --noEmit"
   }
 }