mcp-use 1.11.0-canary.8 → 1.11.0

package/dist/src/server/mcp-server.d.ts

@@ -7,7 +7,7 @@ import type { ToolContext, SampleOptions, ElicitOptions, ElicitFormParams, Elici
 export type { ToolContext, SampleOptions, ElicitOptions, ElicitFormParams, ElicitUrlParams, };
 import { onRootsChanged, listRoots } from "./roots/index.js";
 import type { SessionData } from "./sessions/index.js";
-import { getActiveSessions, sendNotification, sendNotificationToSession } from "./notifications/index.js";
+import { getActiveSessions, sendNotification, sendNotificationToSession, sendToolsListChanged, sendResourcesListChanged, sendPromptsListChanged } from "./notifications/index.js";
 import type { ServerConfig } from "./types/index.js";
 import { parseTemplateUri as parseTemplateUriHelper } from "./utils/index.js";
 import type { OAuthProvider } from "./oauth/providers/types.js";
@@ -122,6 +122,9 @@ declare class MCPServerClass<HasOAuth extends boolean = false> {
     getActiveSessions: typeof getActiveSessions;
     sendNotification: typeof sendNotification;
     sendNotificationToSession: typeof sendNotificationToSession;
+    sendToolsListChanged: typeof sendToolsListChanged;
+    sendResourcesListChanged: typeof sendResourcesListChanged;
+    sendPromptsListChanged: typeof sendPromptsListChanged;
     /**
      * Notify subscribed clients that a resource has been updated
      *

package/dist/src/server/mcp-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../../src/server/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,IAAI,iBAAiB,EAE/B,MAAM,iDAAiD,CAAC;AACzD,OAAO,KAAK,EACV,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,4CAA4C,CAAC;AAKpD,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,MAAM,CAAC;AAK7C,OAAO,EAAE,sBAAsB,EAAgB,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAEL,wBAAwB,EACxB,kBAAkB,EACnB,MAAM,kBAAkB,CAAC;AAS1B,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,EAChB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAQlC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAWL,gBAAgB,IAAI,sBAAsB,EAE3C,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,cAAc,EACd,eAAe,EAChB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC1E,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,cAAM,cAAc,CAAC,QAAQ,SAAS,OAAO,GAAG,KAAK;IACnD;;;OAGG;WACW,iBAAiB,IAAI,MAAM;IAIzC;;;OAGG;IACH,SAAgB,YAAY,EAAE,iBAAiB,CAAC;IAEhD,6EAA6E;IAC7E,IAAW,MAAM,IAAI,iBAAiB,CAErC;IAEM,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,EAAE,QAAQ,CAAC;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,gBAAgB,CAAS;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAM;IAC/B,iBAAiB,EAAE,MAAM,EAAE,CAAM;IACjC,mBAAmB,EAAE,MAAM,EAAE,CAAM;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,2BAAkC;IACjD,OAAO,CAAC,mBAAmB,CAAC,CAAiB;IAC7C,OAAO,CAAC,eAAe,CAMrB;IACK,aAAa,CAAC,EAAE,aAAa,CAAC;IACrC,OAAO,CAAC,eAAe,CAAC,CAAkD;IAE1E;;;;OAIG;IACI,aAAa;;oBACe,cAAc;qBAAW,YAAY;;;oBAG1D,gBAAgB;qBAAW,cAAc;;;oBAIzC,kBAAkB;qBAAW,oBAAoB;;;oBAKjD,0BAA0B;qBACzB,4BAA4B;;MAGzC;IAEF;;;OAGG;IACI,iBAAiB,uCAA8C;IAEtE;;OAEG;IACH,OAAO,CAAC,mBAAmB,CAAqC;IAEhE;;;;;;;;OAQG;IACI,2BAA2B,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAI3D;;;;;;;;;OASG;gBACS,MAAM,EAAE,YAAY;IA4ChC;;;OAGG;IACH,OAAO,CAAC,uBAAuB;IAiK/B;;;OAGG;IACI,mBAAmB,IAAI,iBAAiB;IA0a/C;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IASjB,IAAI,EAAG,CAAC,CAAC,SAAS,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,CAAC,EACzD,cAAc,EAAE,CAAC,EACjB,QAAQ,CAAC,EAAE,YAAY,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,KACrE,IAAI,CAAC;IAGH,wBAAwB,kCAA4B;IACpD,kBAAkB,4BAAsB;IAGxC,gBAAgB,gCAA0B;IAG1C,QAAQ,EAAG,CAChB,kBAAkB,EACd,kBAAkB,CAAC,QAAQ,CAAC,GAC5B,OAAO,kBAAkB,EAAE,iCAAiC,EAChE,QAAQ,CAAC,EAAE,oBAAoB,CAAC,QAAQ,CAAC,KACtC,IAAI,CAAC;IACH,gBAAgB,EAAG,CACxB,kBAAkB,EACd,0BAA0B,CAAC,QAAQ,CAAC,GACpC,OAAO,kBAAkB,EAAE,yCAAyC,GACpE,OAAO,kBAAkB,EAAE,8BAA8B,CAAC,QAAQ,CAAC,GACnE,OAAO,kBAAkB,EAAE,6CAA6C,EAC5E,QAAQ,CAAC,EAAE,4BAA4B,CAAC,QAAQ,CAAC,KAC9C,IAAI,CAAC;IAGH,MAAM,EAAG,CACd,gBAAgB,EACZ,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,GAC/B,OAAO,kBAAkB,EAAE,+BAA+B,EAC9D,QAAQ,CAAC,EAAE,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,KACrC,IAAI,CAAC;IAGH,iBAAiB,2BAAqB;IACtC,gBAAgB,0BAAoB;IACpC,yBAAyB,mCAA6B;IACtD,oBAAoB,8BAAwB;IAC5C,wBAAwB,kCAA4B;IACpD,sBAAsB,gCAA0B;IAEvD;;;;;;;;;;;;;;OAcG;IACU,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD,UAAU,GACf,YAAY,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAC,CAAC,CAAC,SAGxD;IAEF;;;;;;;;;;;;;;;;;;OAkBG;YACW,QAAQ;IActB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQnB,UAAU;IAIV,aAAa;IAIpB;;;OAGG;IACU,aAAa,CACxB,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,EACtC,OAAO,CAAC,EAAE,GAAG,GACZ,OAAO,CAAC,mBAAmB,CAAC;IAIzB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkD1C,OAAO,CAAC,eAAe;IAMvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACG,UAAU,CAAC,OAAO,CAAC,EAAE;QACzB,QAAQ,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,aAAa,CAAC;KACtD,GAAG,OAAO,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAuDhD,cAAc,wBAA6B;IAC3C,SAAS,mBAAwB;IAEjC;;;;;;;;;;;;;;;;;;;;;OAqBG;YACW,cAAc;CAc7B;AAED,MAAM,MAAM,iBAAiB,CAAC,QAAQ,SAAS,OAAO,GAAG,KAAK,IAC5D,cAAc,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC;AAGtC,MAAM,MAAM,SAAS,CAAC,QAAQ,SAAS,OAAO,GAAG,KAAK,IACpD,cAAc,CAAC,QAAQ,CAAC,CAAC;AAG3B,MAAM,WAAW,oBAAoB;IAEnC,KACE,MAAM,EAAE,YAAY,GAAG;QAAE,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;KAAE,GACnE,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAE3B,KAAK,MAAM,EAAE,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACrD,SAAS,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;CACpC;AAMD,eAAO,MAAM,SAAS,EAAE,oBAA4C,CAAC;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAIH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG;IAAE,KAAK,EAAE,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAA;CAAE,GAC5E,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAI3B,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC7B,iBAAiB,CAAC,KAAK,CAAC,CAAC"}

package/dist/src/server/notifications/index.d.ts

@@ -3,5 +3,5 @@
  *
  * This module provides functions for managing client notifications with the MCP server.
  */
-export { getActiveSessions, sendNotification, sendNotificationToSession, type NotificationServerContext, } from "./notification-registration.js";
+export { getActiveSessions, sendNotification, sendNotificationToSession, sendToolsListChanged, sendResourcesListChanged, sendPromptsListChanged, type NotificationServerContext, } from "./notification-registration.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/server/notifications/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/notifications/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,yBAAyB,EACzB,oBAAoB,EACpB,wBAAwB,EACxB,sBAAsB,EACtB,KAAK,yBAAyB,GAC/B,MAAM,gCAAgC,CAAC"}

package/dist/src/server/notifications/notification-registration.d.ts

@@ -79,4 +79,55 @@ export declare function sendNotification(this: NotificationServerContext, method
  * ```
  */
 export declare function sendNotificationToSession(this: NotificationServerContext, sessionId: string, method: string, params?: Record<string, unknown>): Promise<boolean>;
+/**
+ * Notify all clients that the tools list has changed
+ *
+ * Convenience method that sends a `notifications/tools/list_changed` notification
+ * to all connected clients. Use this when dynamically adding or removing tools
+ * to prompt clients to refresh their tools cache.
+ *
+ * Note: This only works in stateful mode with active sessions.
+ *
+ * @example
+ * ```typescript
+ * // After dynamically registering a new tool
+ * server.tool({ name: 'new_tool', ... }, async () => {...});
+ * await server.sendToolsListChanged();
+ * ```
+ */
+export declare function sendToolsListChanged(this: NotificationServerContext): Promise<void>;
+/**
+ * Notify all clients that the resources list has changed
+ *
+ * Convenience method that sends a `notifications/resources/list_changed` notification
+ * to all connected clients. Use this when dynamically adding or removing resources
+ * to prompt clients to refresh their resources cache.
+ *
+ * Note: This only works in stateful mode with active sessions.
+ *
+ * @example
+ * ```typescript
+ * // After dynamically registering a new resource
+ * server.resource({ name: 'new_resource', uri: 'app://new' }, async () => {...});
+ * await server.sendResourcesListChanged();
+ * ```
+ */
+export declare function sendResourcesListChanged(this: NotificationServerContext): Promise<void>;
+/**
+ * Notify all clients that the prompts list has changed
+ *
+ * Convenience method that sends a `notifications/prompts/list_changed` notification
+ * to all connected clients. Use this when dynamically adding or removing prompts
+ * to prompt clients to refresh their prompts cache.
+ *
+ * Note: This only works in stateful mode with active sessions.
+ *
+ * @example
+ * ```typescript
+ * // After dynamically registering a new prompt
+ * server.prompt({ name: 'new_prompt', ... }, async () => {...});
+ * await server.sendPromptsListChanged();
+ * ```
+ */
+export declare function sendPromptsListChanged(this: NotificationServerContext): Promise<void>;
 //# sourceMappingURL=notification-registration.d.ts.map

package/dist/src/server/notifications/notification-registration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-registration.d.ts","sourceRoot":"","sources":["../../../../src/server/notifications/notification-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,EAAE,CAE3E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,yBAAyB,EAC/B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,yBAAyB,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAOlB"}
+{"version":3,"file":"notification-registration.d.ts","sourceRoot":"","sources":["../../../../src/server/notifications/notification-registration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,yBAAyB,GAAG,MAAM,EAAE,CAE3E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,yBAAyB,EAC/B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,yBAAyB,EAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAOlB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAKf"}

package/dist/src/server/sessions/index.d.ts

@@ -1,6 +1,8 @@
 /**
  * Session Management Exports
  */
-export { type SessionData, startIdleCleanup } from "./session-manager.js";
+export { type SessionData, type SessionMetadata, startIdleCleanup, } from "./session-manager.js";
 export { sendNotificationToAll, sendNotificationToSession, } from "./notifications.js";
+export { type SessionStore, InMemorySessionStore, RedisSessionStore, type RedisClient, type RedisSessionStoreConfig, FileSystemSessionStore, type FileSystemSessionStoreConfig, } from "./stores/index.js";
+export { type StreamManager, InMemoryStreamManager, RedisStreamManager, type RedisStreamManagerConfig, } from "./streams/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/server/sessions/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/sessions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,WAAW,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/sessions/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,eAAe,EACpB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,KAAK,YAAY,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,uBAAuB,EAC5B,sBAAsB,EACtB,KAAK,4BAA4B,GAClC,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,KAAK,aAAa,EAClB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,wBAAwB,GAC9B,MAAM,oBAAoB,CAAC"}

package/dist/src/server/sessions/session-manager.d.ts

@@ -8,33 +8,47 @@ import type { Context } from "hono";
 import type { Transport } from "@mcp-use/modelcontextprotocol-sdk/shared/transport.js";
 import type { McpServer } from "@mcp-use/modelcontextprotocol-sdk/server/mcp.js";
 /**
- * Session data stored for each active MCP session
- * Following official SDK pattern - each session has its own transport and server
+ * Serializable session metadata
+ *
+ * This is the data that can be stored in external stores (Redis, Postgres).
+ * It excludes runtime objects like transport and server instances.
  */
-export interface SessionData {
-    /** Reference to this session's transport instance */
-    transport: Transport;
-    /** Reference to this session's server instance */
-    server?: McpServer;
+export interface SessionMetadata {
     /** Timestamp of last activity for idle timeout tracking */
     lastAccessedAt: number;
-    /** Hono context for this session's current request */
-    context?: Context;
+    /** Minimum log level for filtering log messages (RFC 5424 levels) */
+    logLevel?: string;
+    /** Client capabilities advertised during initialization */
+    clientCapabilities?: Record<string, unknown>;
+    /** Client info (name, version) */
+    clientInfo?: Record<string, unknown>;
+    /** Protocol version negotiated during initialization */
+    protocolVersion?: string;
     /** Progress token for current tool call (if any) */
     progressToken?: number;
-    /** Function to send notifications to the client */
+}
+/**
+ * Complete session data including runtime instances
+ *
+ * This extends SessionMetadata with non-serializable runtime objects.
+ * The full SessionData is only available in memory on the server handling the session.
+ */
+export interface SessionData extends SessionMetadata {
+    /** Reference to this session's transport instance (not serializable) */
+    transport: Transport;
+    /** Reference to this session's server instance (not serializable) */
+    server?: McpServer;
+    /** Hono context for this session's current request (not serializable) */
+    context?: Context;
+    /** Function to send notifications to the client (not serializable) */
     sendNotification?: (notification: {
         method: string;
         params: Record<string, unknown>;
     }) => Promise<void>;
-    /** Express-like response object for notifications */
+    /** Express-like response object for notifications (not serializable) */
     expressRes?: Response | Record<string, unknown>;
-    /** Hono context for direct response access */
+    /** Hono context for direct response access (not serializable) */
     honoContext?: Context;
-    /** Minimum log level for filtering log messages (RFC 5424 levels) */
-    logLevel?: string;
-    /** Client capabilities advertised during initialization */
-    clientCapabilities?: Record<string, unknown>;
 }
 /**
  * Start idle session cleanup interval

package/dist/src/server/sessions/session-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../../src/server/sessions/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uDAAuD,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iDAAiD,CAAC;AAEjF;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,qDAAqD;IACrD,SAAS,EAAE,SAAS,CAAC;IACrB,kDAAkD;IAClD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,sDAAsD;IACtD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,qDAAqD;IACrD,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,8CAA8C;IAC9C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAClC,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC,EAChE,iBAAiB,CAAC,EAAE;IAClB,2BAA2B,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D,GACA,MAAM,CAAC,OAAO,GAAG,SAAS,CAyC5B"}
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../../../../src/server/sessions/session-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uDAAuD,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iDAAiD,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,cAAc,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oDAAoD;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAY,SAAQ,eAAe;IAClD,wEAAwE;IACxE,SAAS,EAAE,SAAS,CAAC;IACrB,qEAAqE;IACrE,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,CAAC,YAAY,EAAE;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACjC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpB,wEAAwE;IACxE,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChD,iEAAiE;IACjE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAClC,aAAa,EAAE,MAAM,EACrB,UAAU,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;CAAE,CAAC,EAChE,iBAAiB,CAAC,EAAE;IAClB,2BAA2B,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3D,GACA,MAAM,CAAC,OAAO,GAAG,SAAS,CAyC5B"}

package/dist/src/server/sessions/stores/filesystem.d.ts

@@ -0,0 +1,121 @@
+/**
+ * FileSystem Session Store
+ *
+ * Development-friendly session storage that persists to disk.
+ * Sessions survive server hot reloads, eliminating the need for client re-initialization.
+ *
+ * Designed for:
+ * - Development environments with hot reload (tsx, nodemon, etc.)
+ * - Single-instance deployments requiring session persistence
+ * - Testing scenarios where session state needs to persist
+ *
+ * Not suitable for:
+ * - Production deployments (use InMemorySessionStore or RedisSessionStore)
+ * - Distributed/clustered deployments (use RedisSessionStore)
+ * - High-throughput scenarios (frequent disk I/O may impact performance)
+ */
+import type { SessionStore } from "./index.js";
+import type { SessionMetadata } from "../session-manager.js";
+/**
+ * Configuration for FileSystem session store
+ */
+export interface FileSystemSessionStoreConfig {
+    /**
+     * Path to the session file (default: .mcp-use/sessions.json in project root)
+     */
+    path?: string;
+    /**
+     * Debounce delay in milliseconds for write operations (default: 100)
+     * Reduces disk I/O by batching rapid consecutive writes
+     */
+    debounceMs?: number;
+    /**
+     * Maximum session age in milliseconds (default: 24 hours)
+     * Sessions older than this are cleaned up on load
+     */
+    maxAgeMs?: number;
+}
+/**
+ * FileSystem-based session storage (default for development mode)
+ *
+ * Persists session metadata to a JSON file on disk, enabling sessions to survive
+ * server restarts during hot reload. Uses atomic writes and debouncing for reliability.
+ *
+ * @example
+ * ```typescript
+ * import { MCPServer, FileSystemSessionStore } from 'mcp-use/server';
+ *
+ * const server = new MCPServer({
+ *   name: 'dev-server',
+ *   version: '1.0.0',
+ *   sessionStore: new FileSystemSessionStore({
+ *     path: '.mcp-use/sessions.json'
+ *   })
+ * });
+ * ```
+ */
+export declare class FileSystemSessionStore implements SessionStore {
+    private sessions;
+    private readonly filePath;
+    private readonly debounceMs;
+    private readonly maxAgeMs;
+    private saveTimer;
+    private saving;
+    private pendingSave;
+    constructor(config?: FileSystemSessionStoreConfig);
+    /**
+     * Load sessions from file synchronously during construction
+     * This ensures sessions are available immediately when the server starts
+     */
+    private loadSessionsSync;
+    /**
+     * Retrieve session metadata by ID
+     */
+    get(sessionId: string): Promise<SessionMetadata | null>;
+    /**
+     * Store or update session metadata
+     * Uses debouncing to batch rapid consecutive writes
+     */
+    set(sessionId: string, data: SessionMetadata): Promise<void>;
+    /**
+     * Delete session metadata
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * Check if session exists
+     */
+    has(sessionId: string): Promise<boolean>;
+    /**
+     * List all session IDs
+     */
+    keys(): Promise<string[]>;
+    /**
+     * Store session metadata with TTL
+     * Note: TTL is enforced on load, not with timers (simple implementation)
+     */
+    setWithTTL(sessionId: string, data: SessionMetadata, ttlMs: number): Promise<void>;
+    /**
+     * Get the number of active sessions
+     */
+    get size(): number;
+    /**
+     * Clear all sessions
+     */
+    clear(): Promise<void>;
+    /**
+     * Schedule a save operation with debouncing
+     * Prevents excessive disk I/O from rapid consecutive writes
+     */
+    private scheduleSave;
+    /**
+     * Perform the actual save operation with atomic writes
+     * Uses write-to-temp-then-rename pattern to prevent corruption
+     */
+    private performSave;
+    /**
+     * Force an immediate save (bypasses debouncing)
+     * Useful for ensuring persistence before process exit
+     */
+    flush(): Promise<void>;
+}
+//# sourceMappingURL=filesystem.d.ts.map

package/dist/src/server/sessions/stores/filesystem.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem.d.ts","sourceRoot":"","sources":["../../../../../src/server/sessions/stores/filesystem.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,sBAAuB,YAAW,YAAY;IACzD,OAAO,CAAC,QAAQ,CAAsC;IACtD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,GAAE,4BAAiC;IAUrD;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAsDxB;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAK7D;;;OAGG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlE;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/B;;;OAGG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAgBhB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;OAGG;YACW,YAAY;IAkB1B;;;OAGG;YACW,WAAW;IAiDzB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/src/server/sessions/stores/index.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Session Storage Interface
+ *
+ * Pluggable session storage for MCP servers to support different persistence backends.
+ * Default implementation is in-memory (InMemorySessionStore).
+ *
+ * For persistent sessions across server restarts, implement custom stores:
+ * - RedisSessionStore (for distributed deployments)
+ * - PostgresSessionStore (for database-backed persistence)
+ * - FileSystemSessionStore (for simple file-based persistence)
+ */
+import type { SessionMetadata } from "../session-manager.js";
+/**
+ * Abstract interface for session metadata storage
+ *
+ * Stores ONLY serializable session metadata (client capabilities, log level, timestamps).
+ * Does NOT store runtime objects (transport, server instances, controllers).
+ *
+ * For managing active SSE connections, use StreamManager.
+ *
+ * Inspired by tmcp's split architecture (InfoSessionManager + StreamSessionManager).
+ * All methods are async to support external storage backends (Redis, Postgres, etc.)
+ *
+ * @example
+ * ```typescript
+ * // Custom Redis implementation
+ * class RedisSessionStore implements SessionStore {
+ *   constructor(private redis: RedisClient) {}
+ *
+ *   async get(sessionId: string): Promise<SessionMetadata | null> {
+ *     const data = await this.redis.get(`session:${sessionId}`);
+ *     return data ? JSON.parse(data) : null;
+ *   }
+ *
+ *   async set(sessionId: string, data: SessionMetadata): Promise<void> {
+ *     await this.redis.set(`session:${sessionId}`, JSON.stringify(data));
+ *   }
+ *
+ *   async delete(sessionId: string): Promise<void> {
+ *     await this.redis.del(`session:${sessionId}`);
+ *   }
+ *
+ *   async has(sessionId: string): Promise<boolean> {
+ *     return (await this.redis.exists(`session:${sessionId}`)) === 1;
+ *   }
+ *
+ *   async keys(): Promise<string[]> {
+ *     return await this.redis.keys('session:*');
+ *   }
+ * }
+ * ```
+ */
+export interface SessionStore {
+    /**
+     * Retrieve session metadata by ID
+     * @param sessionId - The unique session identifier
+     * @returns Session metadata if found, null otherwise
+     */
+    get(sessionId: string): Promise<SessionMetadata | null>;
+    /**
+     * Store or update session metadata
+     * @param sessionId - The unique session identifier
+     * @param data - Session metadata to store (serializable only)
+     */
+    set(sessionId: string, data: SessionMetadata): Promise<void>;
+    /**
+     * Delete session metadata
+     * @param sessionId - The unique session identifier
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * Check if session metadata exists
+     * @param sessionId - The unique session identifier
+     * @returns True if session exists, false otherwise
+     */
+    has(sessionId: string): Promise<boolean>;
+    /**
+     * List all session IDs
+     * Used for cleanup operations and monitoring
+     * @returns Array of session IDs
+     */
+    keys(): Promise<string[]>;
+    /**
+     * Optional: Store session metadata with automatic expiration (TTL)
+     * @param sessionId - The unique session identifier
+     * @param data - Session metadata to store
+     * @param ttlMs - Time to live in milliseconds
+     */
+    setWithTTL?(sessionId: string, data: SessionMetadata, ttlMs: number): Promise<void>;
+}
+export * from "./memory.js";
+export * from "./redis.js";
+export * from "./filesystem.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/server/sessions/stores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/server/sessions/stores/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAExD;;;;OAIG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D;;;OAGG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC;;;;OAIG;IACH,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEzC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE1B;;;;;OAKG;IACH,UAAU,CAAC,CACT,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB;AAED,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC"}

package/dist/src/server/sessions/stores/memory.d.ts

@@ -0,0 +1,82 @@
+/**
+ * In-Memory Session Store
+ *
+ * Default session storage implementation using JavaScript Map.
+ * Sessions are stored in memory and lost on server restart.
+ *
+ * For production deployments requiring session persistence across restarts,
+ * consider implementing a custom SessionStore backed by Redis, PostgreSQL,
+ * or another persistent storage system.
+ */
+import type { SessionStore } from "./index.js";
+import type { SessionMetadata } from "../session-manager.js";
+/**
+ * In-memory session storage (default)
+ *
+ * Provides fast, local session management without external dependencies.
+ * Suitable for:
+ * - Development environments
+ * - Single-instance deployments
+ * - Stateful applications where session loss on restart is acceptable
+ *
+ * Not suitable for:
+ * - Distributed/clustered deployments
+ * - Applications requiring session persistence across restarts
+ * - Horizontal scaling scenarios
+ *
+ * @example
+ * ```typescript
+ * import { MCPServer, InMemorySessionStore } from 'mcp-use/server';
+ *
+ * const server = new MCPServer({
+ *   name: 'my-server',
+ *   version: '1.0.0',
+ *   sessionStore: new InMemorySessionStore()
+ * });
+ * ```
+ */
+export declare class InMemorySessionStore implements SessionStore {
+    /**
+     * Internal map storing session metadata
+     * Key: sessionId, Value: SessionMetadata
+     */
+    private sessions;
+    /**
+     * Retrieve session metadata by ID
+     */
+    get(sessionId: string): Promise<SessionMetadata | null>;
+    /**
+     * Store or update session metadata
+     */
+    set(sessionId: string, data: SessionMetadata): Promise<void>;
+    /**
+     * Delete session metadata
+     */
+    delete(sessionId: string): Promise<void>;
+    /**
+     * Check if session exists
+     */
+    has(sessionId: string): Promise<boolean>;
+    /**
+     * List all session IDs
+     */
+    keys(): Promise<string[]>;
+    /**
+     * Store session metadata with TTL (time-to-live)
+     *
+     * Note: In-memory implementation uses setTimeout for TTL.
+     * For production TTL support, use Redis or another store with native TTL.
+     */
+    setWithTTL(sessionId: string, data: SessionMetadata, ttlMs: number): Promise<void>;
+    /**
+     * Get the number of active sessions
+     * Useful for monitoring and debugging
+     */
+    get size(): number;
+    /**
+     * Clear all sessions
+     * Useful for testing and manual cleanup
+     */
+    clear(): Promise<void>;
+}
+//# sourceMappingURL=memory.d.ts.map

package/dist/src/server/sessions/stores/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../../../../src/server/sessions/stores/memory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAsC;IAEtD;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAK7D;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE;;OAEG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C;;OAEG;IACG,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI9C;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/B;;;;;OAKG;IACG,UAAU,CACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAUhB;;;OAGG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}