mcp-server-framework 1.0.0

package/build/server/session/in-memory-store.js

@@ -0,0 +1,312 @@
+/**
+ * In-Memory Session Store
+ *
+ * Built-in session store implementation using a `Map`.
+ * Suitable for single-instance deployments.
+ *
+ * For horizontal scaling, implement the {@link SessionStore} interface
+ * with a shared backend (Redis, PostgreSQL, etc.).
+ *
+ * Contains NO timer logic — background tasks are handled by SessionHousekeeper.
+ *
+ * @module server/session/in-memory-store
+ */
+import { logger as baseLogger } from "../../logger/index.js";
+import { createSession, SESSION_STATES, SESSION_CLOSE_REASONS } from "./session.js";
+// ============================================================================
+// Constants
+// ============================================================================
+const LOG_COMPONENT = "session-store";
+const LogMessages = {
+    SESSION_CREATED: "Session created: %s type=%s (active=%d)",
+    SESSION_CLOSED: "Session closed: %s reason=%s (active=%d)",
+    SESSION_LIMIT_REACHED: "Session limit reached: %d/%d",
+    BROADCAST_TOOL_LIST: "Broadcasting tool list changed to %d sessions",
+    BROADCAST_RESOURCE_LIST: "Broadcasting resource list changed to %d sessions",
+    BROADCAST_PROMPT_LIST: "Broadcasting prompt list changed to %d sessions",
+    SHUTDOWN_STARTED: "Closing all sessions (%d active)",
+    SHUTDOWN_COMPLETE: "All sessions closed",
+};
+const logger = baseLogger.child({ component: LOG_COMPONENT });
+// ============================================================================
+// In-Memory Session Store
+// ============================================================================
+/**
+ * Built-in in-memory session store using a `Map`.
+ *
+ * Suitable for single-instance deployments. For horizontal scaling,
+ * implement the {@link SessionStore} interface with a shared backend.
+ *
+ * Responsibilities:
+ * - Create, get, close, and query sessions
+ * - Enforce capacity limits
+ * - Track statistics (created, peak, by transport type)
+ * - Broadcast notifications to all connected clients
+ *
+ * Does NOT manage timers or background tasks.
+ *
+ * @example
+ * ```typescript
+ * const store = new InMemorySessionStore(100);
+ *
+ * const session = store.create({ transportType: 'http', transport, mcpSession });
+ * const found = store.get(session.id);
+ * store.broadcastToolListChanged();
+ * await store.close(session.id, SESSION_CLOSE_REASONS.CLIENT_DISCONNECT);
+ * ```
+ */
+export class InMemorySessionStore {
+    maxSessions;
+    /** Active sessions indexed by session ID */
+    sessions = new Map();
+    /** Statistics counters */
+    statsCounters = {
+        totalCreated: 0,
+        peakConcurrent: 0,
+        timeoutCount: 0,
+        heartbeatFailureCount: 0,
+    };
+    /** Sessions by transport type (for stats) */
+    byTransportType = {
+        http: 0,
+        https: 0,
+        sse: 0,
+        stdio: 0,
+    };
+    /** Whether the store is rejecting new sessions */
+    isShuttingDown = false;
+    constructor(maxSessions) {
+        this.maxSessions = maxSessions;
+    }
+    // ==========================================================================
+    // Properties
+    // ==========================================================================
+    get size() {
+        return this.sessions.size;
+    }
+    get stats() {
+        return {
+            activeCount: this.sessions.size,
+            maxSessions: this.maxSessions,
+            totalCreated: this.statsCounters.totalCreated,
+            peakConcurrent: this.statsCounters.peakConcurrent,
+            timeoutCount: this.statsCounters.timeoutCount,
+            heartbeatFailureCount: this.statsCounters.heartbeatFailureCount,
+            byTransportType: { ...this.byTransportType },
+        };
+    }
+    // ==========================================================================
+    // CRUD Operations
+    // ==========================================================================
+    /**
+     * Creates and registers a new session.
+     *
+     * Capacity check and insertion are synchronous (no await between them),
+     * which is safe in Node.js single-threaded event loop. Do NOT introduce
+     * any async operations between hasCapacity() and sessions.set().
+     *
+     * @param options - Session creation options
+     * @returns The created session, or undefined if at max capacity or shutting down
+     */
+    create(options) {
+        if (this.isShuttingDown || this.sessions.size >= this.maxSessions) {
+            if (!this.isShuttingDown) {
+                logger.warn(LogMessages.SESSION_LIMIT_REACHED, this.sessions.size, this.maxSessions);
+            }
+            return undefined;
+        }
+        // IMPORTANT: No await between capacity check above and Map.set() below.
+        // This keeps the check-and-insert atomic within the same microtask.
+        const session = createSession(options);
+        session.state = SESSION_STATES.ACTIVE;
+        this.sessions.set(session.id, session);
+        // Update statistics
+        this.statsCounters.totalCreated++;
+        this.byTransportType[session.transport.type]++;
+        if (this.sessions.size > this.statsCounters.peakConcurrent) {
+            this.statsCounters.peakConcurrent = this.sessions.size;
+        }
+        logger.info(LogMessages.SESSION_CREATED, session.id, session.transport.type, this.sessions.size);
+        return session;
+    }
+    /**
+     * Gets an active session by ID.
+     * Does NOT update activity time (use touch() for that).
+     */
+    get(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session && session.state === SESSION_STATES.ACTIVE) {
+            return session;
+        }
+        return undefined;
+    }
+    /**
+     * Checks if a session exists and is active.
+     */
+    has(sessionId) {
+        const session = this.sessions.get(sessionId);
+        return session !== undefined && session.state === SESSION_STATES.ACTIVE;
+    }
+    /**
+     * Updates the last activity time for a session.
+     * Also resets missed heartbeat count.
+     */
+    touch(sessionId) {
+        const session = this.sessions.get(sessionId);
+        if (session && session.state === SESSION_STATES.ACTIVE) {
+            session.metadata.lastActivityAt = new Date();
+            session.transport.heartbeat = {
+                ...session.transport.heartbeat,
+                missedCount: 0,
+            };
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Checks if there's capacity for new sessions.
+     */
+    hasCapacity() {
+        return this.sessions.size < this.maxSessions;
+    }
+    // ==========================================================================
+    // Lifecycle
+    // ==========================================================================
+    /**
+     * Removes a session from the store and updates statistics.
+     *
+     * Pure data operation — does NOT close transport or dispose MCP session.
+     * The caller (SessionManager) is responsible for I/O teardown.
+     *
+     * @param sessionId - Session identifier
+     * @param reason - Reason for closure (tracked in stats)
+     * @returns The removed session, or undefined if not found
+     */
+    remove(sessionId, reason) {
+        const session = this.sessions.get(sessionId);
+        if (!session) {
+            return undefined;
+        }
+        // Track close reason in stats
+        if (reason === SESSION_CLOSE_REASONS.TIMEOUT) {
+            this.statsCounters.timeoutCount++;
+        }
+        else if (reason === SESSION_CLOSE_REASONS.HEARTBEAT_FAILURE) {
+            this.statsCounters.heartbeatFailureCount++;
+        }
+        session.state = SESSION_STATES.CLOSING;
+        this.byTransportType[session.transport.type]--;
+        this.sessions.delete(sessionId);
+        logger.info(LogMessages.SESSION_CLOSED, sessionId, reason, this.sessions.size);
+        return session;
+    }
+    /**
+     * Removes all sessions from the store during shutdown.
+     * Returns the removed sessions for the caller to handle I/O teardown.
+     */
+    removeAll() {
+        this.isShuttingDown = true;
+        const sessionCount = this.sessions.size;
+        logger.info(LogMessages.SHUTDOWN_STARTED, sessionCount);
+        const removed = [];
+        for (const sessionId of Array.from(this.sessions.keys())) {
+            const session = this.remove(sessionId, SESSION_CLOSE_REASONS.SHUTDOWN);
+            if (session) {
+                removed.push(session);
+            }
+        }
+        logger.info(LogMessages.SHUTDOWN_COMPLETE);
+        return removed;
+    }
+    /**
+     * Marks the store as shutting down (rejects new sessions).
+     */
+    markShuttingDown() {
+        this.isShuttingDown = true;
+    }
+    // ==========================================================================
+    // Queries
+    // ==========================================================================
+    /**
+     * Iterates over all active sessions.
+     */
+    forEach(callback) {
+        for (const session of this.sessions.values()) {
+            callback(session, session.id);
+        }
+    }
+    /**
+     * Finds sessions matching a predicate.
+     */
+    filter(predicate) {
+        const results = [];
+        for (const session of this.sessions.values()) {
+            if (predicate(session)) {
+                results.push(session);
+            }
+        }
+        return results;
+    }
+    /**
+     * Gets all sessions of a specific transport type.
+     */
+    getByTransportType(type) {
+        return this.filter((session) => session.transport.type === type);
+    }
+    // ==========================================================================
+    // Broadcasting
+    // ==========================================================================
+    /**
+     * Broadcasts tool list changed notification to all active sessions.
+     */
+    broadcastToolListChanged() {
+        this.broadcastToSessions(LogMessages.BROADCAST_TOOL_LIST, (sdk) => sdk.sendToolListChanged());
+    }
+    broadcastResourceListChanged() {
+        this.broadcastToSessions(LogMessages.BROADCAST_RESOURCE_LIST, (sdk) => sdk.sendResourceListChanged());
+    }
+    broadcastPromptListChanged() {
+        this.broadcastToSessions(LogMessages.BROADCAST_PROMPT_LIST, (sdk) => sdk.sendPromptListChanged());
+    }
+    broadcastResourceUpdated(uri) {
+        const activeCount = this.sessions.size;
+        if (activeCount === 0) {
+            return;
+        }
+        for (const session of this.sessions.values()) {
+            if (session.state === SESSION_STATES.ACTIVE) {
+                // Delegate to McpSession which checks subscription state
+                session.mcpSession.sendResourceUpdated(uri).catch((error) => {
+                    logger.warn("Error sending resource updated to session %s: %s", session.id, String(error));
+                });
+            }
+        }
+    }
+    /**
+     * Broadcasts a notification to all active sessions.
+     * @internal
+     */
+    broadcastToSessions(logMessage, action) {
+        const activeCount = this.sessions.size;
+        if (activeCount === 0) {
+            return;
+        }
+        logger.trace(logMessage, activeCount);
+        for (const session of this.sessions.values()) {
+            if (session.state === SESSION_STATES.ACTIVE) {
+                try {
+                    const result = action(session.mcpSession.sdk);
+                    if (result instanceof Promise) {
+                        result.catch((error) => {
+                            logger.warn("Error broadcasting to session %s: %s", session.id, String(error));
+                        });
+                    }
+                }
+                catch (error) {
+                    logger.warn("Error broadcasting to session %s: %s", session.id, String(error));
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=in-memory-store.js.map

package/build/server/session/in-memory-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-memory-store.js","sourceRoot":"","sources":["../../../src/server/session/in-memory-store.ts"],"names":[],"mappings":"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"}

package/build/server/session/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Session Module
+ *
+ * Unified session management for the MCP Server Framework.
+ * The Session is the single source of truth for each connected MCP client.
+ *
+ * ## Architecture
+ *
+ * ```
+ * Session (source of truth per client)
+ * ├── id              (unique identifier)
+ * ├── state           (lifecycle: created → active → closing → closed)
+ * ├── transport       → TransportContext
+ * │   ├── type        (http | sse | stdio)
+ * │   ├── transport   (MCP SDK transport)
+ * │   └── heartbeat   (state tracking)
+ * ├── mcpSession      → McpSession
+ * │   ├── sdk         (MCP SDK server)
+ * │   └── register*() (SDK registration methods)
+ * ├── auth            → AuthContext (auth/)
+ * │   ├── sdkAuthInfo (SDK AuthInfo wrapper)
+ * │   ├── userId?     (authenticated user)
+ * │   └── permissions (access scopes)
+ * ├── clientInfo      (name, version, remoteAddress)
+ * └── metadata        → SessionMetadata (createdAt, lastActivityAt)
+ * ```
+ *
+ * @module server/session
+ */
+export type { TransportType, HeartbeatCapableTransport, HeartbeatState, TransportContext, } from "../transport/transport-context.js";
+export { createTransportContext, isHeartbeatCapable } from "../transport/transport-context.js";
+export type { AuthInfo, AuthContext } from "../auth/index.js";
+export { ANONYMOUS_AUTH, createAuthContext } from "../auth/index.js";
+export type { SessionState, SessionCloseReason, ClientInfo, SessionMetadata, Session, ReadonlySession, CreateSessionOptions, } from "./session.js";
+export { createSession, SESSION_STATES, SESSION_CLOSE_REASONS } from "./session.js";
+export type { SessionConfig, SessionConfigInput, SessionLifecycleHooks, SessionStats, SessionManager, } from "./session-manager.js";
+export { SessionManagerImpl } from "./session-manager.js";
+export type { SessionStore } from "./session-store.js";
+export { InMemorySessionStore } from "./in-memory-store.js";
+export { SessionHousekeeper, type HousekeeperConfig, type CloseSessionCallback } from "./session-housekeeper.js";
+export { McpSession, type McpSessionOptions, type CloseCallback, type ErrorCallback } from "./mcp-session.js";
+export { McpSessionFactory, type SessionFactoryConfig } from "./session-factory.js";
+//# sourceMappingURL=index.d.ts.map

package/build/server/session/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAMH,YAAY,EACV,aAAa,EACb,yBAAyB,EACzB,cAAc,EACd,gBAAgB,GACjB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAM/F,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAMrE,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,OAAO,EACP,eAAe,EACf,oBAAoB,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAMpF,YAAY,EACV,aAAa,EACb,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,cAAc,GACf,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAM1D,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAM5D,OAAO,EAAE,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAMjH,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAM9G,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/build/server/session/index.js

@@ -0,0 +1,47 @@
+/**
+ * Session Module
+ *
+ * Unified session management for the MCP Server Framework.
+ * The Session is the single source of truth for each connected MCP client.
+ *
+ * ## Architecture
+ *
+ * ```
+ * Session (source of truth per client)
+ * ├── id              (unique identifier)
+ * ├── state           (lifecycle: created → active → closing → closed)
+ * ├── transport       → TransportContext
+ * │   ├── type        (http | sse | stdio)
+ * │   ├── transport   (MCP SDK transport)
+ * │   └── heartbeat   (state tracking)
+ * ├── mcpSession      → McpSession
+ * │   ├── sdk         (MCP SDK server)
+ * │   └── register*() (SDK registration methods)
+ * ├── auth            → AuthContext (auth/)
+ * │   ├── sdkAuthInfo (SDK AuthInfo wrapper)
+ * │   ├── userId?     (authenticated user)
+ * │   └── permissions (access scopes)
+ * ├── clientInfo      (name, version, remoteAddress)
+ * └── metadata        → SessionMetadata (createdAt, lastActivityAt)
+ * ```
+ *
+ * @module server/session
+ */
+export { createTransportContext, isHeartbeatCapable } from "../transport/transport-context.js";
+export { ANONYMOUS_AUTH, createAuthContext } from "../auth/index.js";
+export { createSession, SESSION_STATES, SESSION_CLOSE_REASONS } from "./session.js";
+export { SessionManagerImpl } from "./session-manager.js";
+export { InMemorySessionStore } from "./in-memory-store.js";
+// ============================================================================
+// Session Housekeeper (internal building block, exposed for advanced use)
+// ============================================================================
+export { SessionHousekeeper } from "./session-housekeeper.js";
+// ============================================================================
+// MCP Session (per-client SDK wrapper)
+// ============================================================================
+export { McpSession } from "./mcp-session.js";
+// ============================================================================
+// MCP Session Factory
+// ============================================================================
+export { McpSessionFactory } from "./session-factory.js";
+//# sourceMappingURL=index.js.map

package/build/server/session/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/session/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAaH,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAQ/F,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAgBrE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAcpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAO1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,+EAA+E;AAC/E,0EAA0E;AAC1E,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAqD,MAAM,0BAA0B,CAAC;AAEjH,+EAA+E;AAC/E,uCAAuC;AACvC,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAkE,MAAM,kBAAkB,CAAC;AAE9G,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,OAAO,EAAE,iBAAiB,EAA6B,MAAM,sBAAsB,CAAC"}

package/build/server/session/mcp-session.d.ts

@@ -0,0 +1,210 @@
+/**
+ * MCP Session
+ *
+ * Represents a single MCP client session. Each session wraps an SDK McpServer
+ * instance with SDK-native cancellation and progress support.
+ *
+ * Key responsibilities:
+ * - One client = one session = one SDK McpServer (1:1 per MCP spec)
+ * - Delegates tool/resource/prompt/task registration to registrar modules
+ * - Manages per-session resource subscriptions
+ * - Uses SDK's native AbortSignal for cancellation (per-request, protocol-managed)
+ *
+ * @module server/session/mcp-session
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { TaskStore, TaskMessageQueue } from "@modelcontextprotocol/sdk/experimental/tasks/interfaces.js";
+import type { HandlersConfig, ToolDefinition, TaskToolDefinition, ResourceStaticDefinition, ResourceTemplateDefinition, PromptDefinition } from "../../mcp/types/index.js";
+import type { LogNotificationHandler, McpLogLevel } from "../../logger/index.js";
+/**
+ * Options for creating an McpSession instance.
+ */
+export interface McpSessionOptions {
+    /** Server name */
+    name: string;
+    /** Server version */
+    version: string;
+    /** Pre-built SDK capabilities (from builder) */
+    capabilities: Record<string, unknown>;
+    /** Protocol handler hooks */
+    handlers?: HandlersConfig | undefined;
+    /** Whether this session operates in stateless mode */
+    stateless?: boolean | undefined;
+    /**
+     * Task store for experimental task support.
+     *
+     * When provided, enables `tasks/*` protocol methods and allows
+     * task-based tools to use `extra.taskStore` in their handlers.
+     *
+     * @experimental MCP Tasks is an experimental SDK feature
+     */
+    taskStore?: TaskStore | undefined;
+    /**
+     * Task message queue for experimental task support.
+     *
+     * Manages server-initiated messages that will be delivered through
+     * the `tasks/result` response stream.
+     *
+     * @experimental MCP Tasks is an experimental SDK feature
+     */
+    taskMessageQueue?: TaskMessageQueue | undefined;
+}
+/**
+ * Callback for session close events.
+ */
+export type CloseCallback = () => void;
+/**
+ * Callback for session error events.
+ */
+export type ErrorCallback = (error: Error) => void;
+/**
+ * A managed MCP client session.
+ *
+ * Each session wraps an SDK McpServer instance. Cancellation and progress
+ * are handled natively by the SDK — no additional tracking layer needed.
+ *
+ * @example
+ * ```typescript
+ * const session = new McpSession({
+ *   name: 'my-server',
+ *   version: '1.0.0',
+ *   capabilities: { tools: {} },
+ * });
+ *
+ * // Access underlying SDK server for transport connection
+ * await session.sdk.connect(transport);
+ * ```
+ */
+export declare class McpSession implements LogNotificationHandler {
+    /** The underlying MCP SDK server instance */
+    readonly sdk: McpServer;
+    /** Session options */
+    readonly options: Readonly<McpSessionOptions>;
+    /** URIs this session has subscribed to for resource update notifications */
+    private readonly subscribedURIs;
+    private readonly logger;
+    private onCloseCallback?;
+    private onErrorCallback?;
+    /**
+     * Creates a new McpSession instance.
+     *
+     * Cancellation is handled natively by the SDK's Protocol layer
+     * (per-request AbortController, keyed by real JSON-RPC request ID).
+     * Progress reporting uses the SDK's extra.sendNotification with
+     * rate-limiting applied by createProgressReporter().
+     *
+     * @param options - Session configuration options
+     */
+    constructor(options: McpSessionOptions);
+    /** Server name */
+    get name(): string;
+    /** Server version */
+    get version(): string;
+    /**
+     * Set callback for session close events.
+     */
+    onClose(callback: CloseCallback): this;
+    /**
+     * Set callback for session error events.
+     */
+    onError(callback: ErrorCallback): this;
+    /**
+     * Clean up session resources.
+     *
+     * Closes the underlying SDK McpServer, releasing protocol-level resources
+     * (pending requests, open streams, registered handlers). This is the
+     * counterpart to `sdk.connect(transport)` — every connected session
+     * should be disposed when no longer needed.
+     *
+     * Called by:
+     * - SessionManager (stateful sessions — on close/closeAll)
+     * - StreamableHttpTransport (stateless sessions — on response close)
+     *
+     * Safe to call multiple times — sdk.close() is idempotent.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Registers all tools with the MCP SDK server.
+     * Delegates to ToolRegistry.bindToSdk().
+     */
+    registerTools(tools: readonly ToolDefinition[]): void;
+    /**
+     * Registers task tools with the MCP SDK's experimental tasks API.
+     * Delegates to TaskToolRegistry.bindToSdk().
+     *
+     * @experimental MCP Tasks is an experimental SDK feature
+     */
+    registerTaskTools(taskTools: readonly TaskToolDefinition[]): void;
+    /**
+     * Registers all resources (static + templates) with the MCP SDK server.
+     * Delegates to ResourceRegistry.bindToSdk().
+     */
+    registerResources(resources: readonly ResourceStaticDefinition[], templates: readonly ResourceTemplateDefinition[]): void;
+    /**
+     * Registers all prompts with the MCP SDK server.
+     * Delegates to PromptRegistry.bindToSdk().
+     */
+    registerPrompts(prompts: readonly PromptDefinition[]): void;
+    /**
+     * Registers request handlers for `resources/subscribe` and `resources/unsubscribe`.
+     *
+     * @sdk-constraint — The SDK's high-level `McpServer` does not handle subscription
+     * requests. This uses the low-level `Server.setRequestHandler()` API to register
+     * handlers for the subscribe/unsubscribe JSON-RPC methods.
+     *
+     * Subscription tracking is per-session (this `McpSession` instance).
+     * When `notifyResourceUpdated(uri)` is called, only sessions that
+     * subscribed to the given URI receive `notifications/resources/updated`.
+     *
+     * In stateless mode, subscriptions are not meaningful (no persistent session),
+     * so this method should not be called for stateless sessions.
+     */
+    registerSubscriptionHandlers(): void;
+    /**
+     * Sends a `notifications/resources/updated` notification to this session's client
+     * if the session has subscribed to the given URI.
+     *
+     * @param uri - The resource URI that was updated
+     */
+    sendResourceUpdated(uri: string): Promise<void>;
+    /**
+     * Sends a log notification to the connected MCP client.
+     * Implements {@link LogNotificationHandler} so this session can be
+     * registered directly with the MCP notification logger.
+     */
+    sendLogNotification(level: McpLogLevel, message: string): Promise<void>;
+    /**
+     * Registers a request handler for `logging/setLevel`.
+     *
+     * Per MCP Spec: When the server declares `logging: {}` capability, clients
+     * can send `logging/setLevel` to control which log notifications they receive.
+     * The handler updates the McpNotificationLogger's minimum level so that
+     * only messages at or above the requested level are forwarded.
+     *
+     * @param onSetLevel - Callback to apply the requested level (typically mcpLogger.setMinLevel)
+     */
+    registerSetLevelHandler(onSetLevel: (level: McpLogLevel) => void): void;
+    /**
+     * Overrides `tools/list`, `resources/list`, `resources/templates/list`, and `prompts/list`
+     * handlers to filter out entries whose `requiredScopes` are not satisfied by the
+     * requesting user's token scopes.
+     *
+     * This wraps the SDK's original handlers — the full list is constructed by the SDK,
+     * then filtered before being returned to the client.
+     *
+     * Call this AFTER all tools/resources/prompts have been registered via `registerTools()` etc.
+     *
+     * @param options - All registered definitions (used to build scope lookup maps)
+     */
+    registerScopeFilteredListHandlers(options: {
+        tools: readonly ToolDefinition[];
+        resources: readonly ResourceStaticDefinition[];
+        templates: readonly ResourceTemplateDefinition[];
+        prompts: readonly PromptDefinition[];
+    }): void;
+    /**
+     * Sets up lifecycle callbacks on the underlying SDK server.
+     */
+    private setupLifecycleCallbacks;
+}
+//# sourceMappingURL=mcp-session.d.ts.map

package/build/server/session/mcp-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-session.d.ts","sourceRoot":"","sources":["../../../src/server/session/mcp-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAOpE,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAC;AAE9G,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAUlC,OAAO,KAAK,EAAE,sBAAsB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAMjF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,sDAAsD;IACtD,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC;;;;;;;OAOG;IACH,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC;AAEvC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AA+BnD;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,YAAW,sBAAsB;IACvD,6CAA6C;IAC7C,SAAgB,GAAG,EAAE,SAAS,CAAC;IAE/B,sBAAsB;IACtB,SAAgB,OAAO,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IAErD,4EAA4E;IAC5E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IAEpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuD;IAE9E,OAAO,CAAC,eAAe,CAAC,CAA4B;IACpD,OAAO,CAAC,eAAe,CAAC,CAA4B;IAEpD;;;;;;;;;OASG;gBACS,OAAO,EAAE,iBAAiB;IA4BtC,kBAAkB;IAClB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,qBAAqB;IACrB,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAKtC;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;IAKtC;;;;;;;;;;;;;OAaG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB9B;;;OAGG;IACH,aAAa,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI;IAOrD;;;;;OAKG;IACH,iBAAiB,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAOjE;;;OAGG;IACH,iBAAiB,CACf,SAAS,EAAE,SAAS,wBAAwB,EAAE,EAC9C,SAAS,EAAE,SAAS,0BAA0B,EAAE,GAC/C,IAAI;IAMP;;;OAGG;IACH,eAAe,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI;IAU3D;;;;;;;;;;;;;OAaG;IACH,4BAA4B,IAAI,IAAI;IAkBpC;;;;;OAKG;IACG,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBrD;;;;OAIG;IACG,mBAAmB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7E;;;;;;;;;OASG;IACH,uBAAuB,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,IAAI;IAgBvE;;;;;;;;;;;OAWG;IACH,iCAAiC,CAAC,OAAO,EAAE;QACzC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;QACjC,SAAS,EAAE,SAAS,wBAAwB,EAAE,CAAC;QAC/C,SAAS,EAAE,SAAS,0BAA0B,EAAE,CAAC;QACjD,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;KACtC,GAAG,IAAI;IA4IR;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAWhC"}