mcp-use 1.9.0 → 1.9.1-canary.1

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":"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"}

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

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

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

@@ -0,0 +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"}

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

@@ -0,0 +1,82 @@
+import type { SessionData } from "../sessions/index.js";
+export interface NotificationServerContext {
+    sessions: Map<string, SessionData>;
+}
+/**
+ * Get array of active session IDs
+ *
+ * Returns an array of all currently active session IDs. This is useful for
+ * sending targeted notifications to specific clients or iterating over
+ * connected clients.
+ *
+ * Note: This only works in stateful mode. In stateless mode (edge environments),
+ * this will return an empty array.
+ *
+ * @returns Array of active session ID strings
+ *
+ * @example
+ * ```typescript
+ * const sessions = server.getActiveSessions();
+ * console.log(`${sessions.length} clients connected`);
+ *
+ * // Send notification to first connected client
+ * if (sessions.length > 0) {
+ *   server.sendNotificationToSession(sessions[0], "custom/hello", { message: "Hi!" });
+ * }
+ * ```
+ */
+export declare function getActiveSessions(this: NotificationServerContext): string[];
+/**
+ * Send a notification to all connected clients
+ *
+ * Broadcasts a JSON-RPC notification to all active sessions. Notifications are
+ * one-way messages that do not expect a response from the client.
+ *
+ * Note: This only works in stateful mode with active sessions. If no sessions
+ * are connected, the notification is silently discarded (per MCP spec: "server MAY send").
+ *
+ * @param method - The notification method name (e.g., "custom/my-notification")
+ * @param params - Optional parameters to include in the notification
+ *
+ * @example
+ * ```typescript
+ * // Send a simple notification to all clients
+ * server.sendNotification("custom/server-status", {
+ *   status: "ready",
+ *   timestamp: new Date().toISOString()
+ * });
+ *
+ * // Notify all clients that resources have changed
+ * server.sendNotification("notifications/resources/list_changed");
+ * ```
+ */
+export declare function sendNotification(this: NotificationServerContext, method: string, params?: Record<string, unknown>): Promise<void>;
+/**
+ * Send a notification to a specific client session
+ *
+ * Sends a JSON-RPC notification to a single client identified by their session ID.
+ * This allows sending customized notifications to individual clients.
+ *
+ * Note: This only works in stateful mode. If the session ID doesn't exist,
+ * the notification is silently discarded.
+ *
+ * @param sessionId - The target session ID (from getActiveSessions())
+ * @param method - The notification method name (e.g., "custom/my-notification")
+ * @param params - Optional parameters to include in the notification
+ * @returns true if the notification was sent, false if session not found
+ *
+ * @example
+ * ```typescript
+ * const sessions = server.getActiveSessions();
+ *
+ * // Send different messages to different clients
+ * sessions.forEach((sessionId, index) => {
+ *   server.sendNotificationToSession(sessionId, "custom/welcome", {
+ *     message: `Hello client #${index + 1}!`,
+ *     clientNumber: index + 1
+ *   });
+ * });
+ * ```
+ */
+export declare function sendNotificationToSession(this: NotificationServerContext, sessionId: string, method: string, params?: Record<string, unknown>): Promise<boolean>;
+//# sourceMappingURL=notification-registration.d.ts.map

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

@@ -0,0 +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"}

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

@@ -10,4 +10,5 @@ export { createBearerAuthMiddleware } from "./middleware.js";
 export { setupOAuthRoutes } from "./routes.js";
 export { getAuth, hasScope, hasAnyScope, requireScope, requireAnyScope, } from "./utils.js";
 export type { AuthInfo } from "./utils.js";
+export { setupOAuthForServer, type OAuthSetupState } from "./setup.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/oauth/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,OAAO,EACP,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/oauth/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGpE,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EACL,OAAO,EACP,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAG3C,OAAO,EAAE,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/server/oauth/setup.d.ts

@@ -0,0 +1,28 @@
+/**
+ * OAuth Setup
+ *
+ * Handles OAuth provider initialization and configuration for MCP servers.
+ */
+import type { Hono as HonoType } from "hono";
+/**
+ * OAuth setup state
+ */
+export interface OAuthSetupState {
+    provider?: any;
+    middleware?: any;
+    complete: boolean;
+}
+/**
+ * Setup OAuth authentication for MCP server
+ *
+ * Initializes OAuth provider, creates bearer auth middleware,
+ * sets up OAuth routes, and applies auth to /mcp endpoints.
+ *
+ * @param app - Hono app instance
+ * @param oauthProvider - OAuth provider instance
+ * @param baseUrl - Server base URL for OAuth redirects
+ * @param state - OAuth setup state to track completion
+ * @returns Updated OAuth setup state with provider and middleware
+ */
+export declare function setupOAuthForServer(app: HonoType, oauthProvider: any, baseUrl: string, state: OAuthSetupState): Promise<OAuthSetupState>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/src/server/oauth/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../src/server/oauth/setup.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,MAAM,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,QAAQ,EACb,aAAa,EAAE,GAAG,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,eAAe,CAAC,CAkC1B"}

package/dist/src/server/prompts/conversion.d.ts

@@ -0,0 +1,22 @@
+import type { CallToolResult, GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Convert CallToolResult to GetPromptResult
+ *
+ * This function enables using tool response helpers (text(), object(), image(), etc.)
+ * in prompt callbacks by converting them to the proper prompt message format.
+ *
+ * According to the MCP spec, prompts return messages with roles and content.
+ * We convert tool-style content to user-role messages.
+ *
+ * @param result - CallToolResult or GetPromptResult to convert
+ * @returns GetPromptResult with proper prompt messages
+ *
+ * @example
+ * ```typescript
+ * const toolResult = text("Please review this code");
+ * const promptResult = convertToolResultToPromptResult(toolResult);
+ * // Returns: { messages: [{ role: "user", content: { type: "text", text: "Please review this code" } }] }
+ * ```
+ */
+export declare function convertToolResultToPromptResult(result: CallToolResult | GetPromptResult): GetPromptResult;
+//# sourceMappingURL=conversion.d.ts.map

package/dist/src/server/prompts/conversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion.d.ts","sourceRoot":"","sources":["../../../../src/server/prompts/conversion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEhB,MAAM,oCAAoC,CAAC;AAW5C;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,cAAc,GAAG,eAAe,GACvC,eAAe,CAuFjB"}

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

@@ -0,0 +1,60 @@
+import type { GetPromptResult } from "@modelcontextprotocol/sdk/types.js";
+import type { PromptDefinition, PromptDefinitionWithoutCallback, PromptCallback } from "../types.js";
+export interface PromptServerContext {
+    server: {
+        registerPrompt(name: string, metadata: {
+            title?: string;
+            description: string;
+            argsSchema: any;
+        }, getPromptCallback: (params: any) => Promise<GetPromptResult>): void;
+    };
+    registeredPrompts: string[];
+    createParamsSchema: (args: any[]) => any;
+    convertZodSchemaToParams: (schema: any) => any;
+}
+/**
+ * Define a prompt template
+ *
+ * Registers a prompt template with the MCP server that clients can use to generate
+ * structured prompts for AI models. Prompts can now use the same response helpers
+ * as tools (text(), object(), markdown(), etc.) for a unified API.
+ *
+ * Supports two patterns:
+ * 1. Old API: Single object with cb property
+ * 2. New API: Definition object + separate callback (like tools and resources)
+ *
+ * @param promptDefinition - Configuration object containing prompt metadata
+ * @param promptDefinition.name - Unique identifier for the prompt template
+ * @param promptDefinition.description - Human-readable description of the prompt's purpose
+ * @param promptDefinition.args - Array of argument definitions (legacy, use schema instead)
+ * @param promptDefinition.schema - Zod object schema for input validation (preferred)
+ * @param callback - Optional separate callback function (new API pattern)
+ * @returns The server instance for method chaining
+ *
+ * @example
+ * ```typescript
+ * // New API: Using response helpers (recommended)
+ * server.prompt(
+ *   {
+ *     name: 'code-review',
+ *     description: 'Generates a code review prompt',
+ *     schema: z.object({ language: z.string(), code: z.string() })
+ *   },
+ *   async ({ language, code }) => text(`Please review this ${language} code:\n\n${code}`)
+ * )
+ *
+ * // Old API: Still supported for backward compatibility
+ * server.prompt({
+ *   name: 'greeting',
+ *   args: [{ name: 'name', type: 'string', required: true }],
+ *   cb: async ({ name }) => ({
+ *     messages: [{
+ *       role: 'user',
+ *       content: { type: 'text', text: `Hello, ${name}!` }
+ *     }]
+ *   })
+ * })
+ * ```
+ */
+export declare function registerPrompt(this: PromptServerContext, promptDefinition: PromptDefinition | PromptDefinitionWithoutCallback, callback?: PromptCallback): PromptServerContext;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EACV,gBAAgB,EAChB,+BAA+B,EAC/B,cAAc,EACf,MAAM,aAAa,CAAC;AAGrB,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE;QACN,cAAc,CACZ,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE;YACR,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;YACpB,UAAU,EAAE,GAAG,CAAC;SACjB,EACD,iBAAiB,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAAC,eAAe,CAAC,GAC3D,IAAI,CAAC;KACT,CAAC;IACF,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,kBAAkB,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,CAAC;IACzC,wBAAwB,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,GAAG,CAAC;CAChD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,mBAAmB,EACzB,gBAAgB,EAAE,gBAAgB,GAAG,+BAA+B,EACpE,QAAQ,CAAC,EAAE,cAAc,GACxB,mBAAmB,CAiFrB"}

package/dist/src/server/resources/conversion.d.ts

@@ -0,0 +1,20 @@
+import type { CallToolResult, ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+/**
+ * Convert CallToolResult to ReadResourceResult
+ *
+ * This function enables using tool response helpers (text(), object(), image(), etc.)
+ * in resource callbacks by converting them to the proper resource format.
+ *
+ * @param uri - The resource URI
+ * @param result - CallToolResult or ReadResourceResult to convert
+ * @returns ReadResourceResult with proper resource contents
+ *
+ * @example
+ * ```typescript
+ * const toolResult = text("Hello World");
+ * const resourceResult = convertToolResultToResourceResult("app://greeting", toolResult);
+ * // Returns: { contents: [{ uri: "app://greeting", mimeType: "text/plain", text: "Hello World" }] }
+ * ```
+ */
+export declare function convertToolResultToResourceResult(uri: string, result: CallToolResult | ReadResourceResult): ReadResourceResult;
+//# sourceMappingURL=conversion.d.ts.map

package/dist/src/server/resources/conversion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion.d.ts","sourceRoot":"","sources":["../../../../src/server/resources/conversion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAEnB,MAAM,oCAAoC,CAAC;AA4D5C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iCAAiC,CAC/C,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,GAAG,kBAAkB,GAC1C,kBAAkB,CA6FpB"}

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

@@ -0,0 +1,117 @@
+import type { ResourceDefinition, ReadResourceCallback, ReadResourceTemplateCallback, ResourceDefinitionWithoutCallback, ResourceTemplateDefinitionWithoutCallback } from "../types/index.js";
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+import type { ResourceTemplateDefinition } from "../types/index.js";
+export { ResourceSubscriptionManager } from "./subscriptions.js";
+export interface ResourceServerContext {
+    server: {
+        registerResource(name: string, uri: string, metadata: {
+            title?: string;
+            description?: string;
+            mimeType: string;
+            _meta?: Record<string, unknown>;
+        }, readCallback: () => Promise<ReadResourceResult>): void;
+    };
+    registeredResources: string[];
+}
+/**
+ * Define a static resource that can be accessed by clients
+ *
+ * Registers a resource with the MCP server that clients can access via HTTP.
+ * Resources are static content like files, data, or pre-computed results that
+ * can be retrieved by clients without requiring parameters.
+ *
+ * Supports two patterns:
+ * 1. Old API: Single object with readCallback property
+ * 2. New API: Definition object + separate callback (like tools)
+ *
+ * @param resourceDefinition - Configuration object containing resource metadata
+ * @param resourceDefinition.name - Unique identifier for the resource
+ * @param resourceDefinition.uri - URI pattern for accessing the resource
+ * @param resourceDefinition.title - Optional human-readable title for the resource
+ * @param resourceDefinition.description - Optional description of the resource
+ * @param resourceDefinition.mimeType - MIME type (optional when using callback with response helpers)
+ * @param resourceDefinition.annotations - Optional annotations (audience, priority, lastModified)
+ * @param callback - Optional separate callback function (new API pattern)
+ * @returns The server instance for method chaining
+ *
+ * @example
+ * ```typescript
+ * // New API: Using response helpers (recommended)
+ * server.resource(
+ *   { name: 'greeting', uri: 'app://greeting', title: 'Greeting' },
+ *   async () => text('Hello World!')
+ * )
+ *
+ * server.resource(
+ *   { name: 'config', uri: 'config://settings' },
+ *   async () => object({ theme: 'dark', version: '1.0' })
+ * )
+ *
+ * // Old API: Still supported for backward compatibility
+ * server.resource({
+ *   name: 'config',
+ *   uri: 'config://app-settings',
+ *   mimeType: 'application/json',
+ *   readCallback: async () => ({
+ *     contents: [{
+ *       uri: 'config://app-settings',
+ *       mimeType: 'application/json',
+ *       text: JSON.stringify({ theme: 'dark' })
+ *     }]
+ *   })
+ * })
+ * ```
+ */
+export declare function registerResource(this: ResourceServerContext, resourceDefinition: ResourceDefinition | ResourceDefinitionWithoutCallback, callback?: ReadResourceCallback): ResourceServerContext;
+export interface ResourceTemplateServerContext {
+    server: {
+        registerResource(name: string, template: ResourceTemplate, metadata: any, readCallback: (uri: URL) => Promise<any>): void;
+    };
+    registeredResources: string[];
+    parseTemplateUri(uriTemplate: string, uri: string): Record<string, string>;
+}
+/**
+ * Define a dynamic resource template with parameters
+ *
+ * Registers a parameterized resource template with the MCP server. Templates use URI
+ * patterns with placeholders that can be filled in at request time, allowing dynamic
+ * resource generation based on parameters.
+ *
+ * Supports two patterns:
+ * 1. Old API: Single object with readCallback property
+ * 2. New API: Definition object + separate callback (like tools)
+ *
+ * @param resourceTemplateDefinition - Configuration object for the resource template
+ * @param resourceTemplateDefinition.name - Unique identifier for the template
+ * @param resourceTemplateDefinition.resourceTemplate - ResourceTemplate object with uriTemplate and metadata
+ * @param callback - Optional separate callback function (new API pattern)
+ * @returns The server instance for method chaining
+ *
+ * @example
+ * ```typescript
+ * // New API: Using response helpers (recommended)
+ * server.resourceTemplate(
+ *   { name: 'user', resourceTemplate: { uriTemplate: 'user://{id}' } },
+ *   async (uri, { id }) => object(await getUserData(id))
+ * )
+ *
+ * // Old API: Still supported for backward compatibility
+ * server.resourceTemplate({
+ *   name: 'user-profile',
+ *   resourceTemplate: {
+ *     uriTemplate: 'user://{userId}/profile',
+ *     mimeType: 'application/json'
+ *   },
+ *   readCallback: async (uri, params) => ({
+ *     contents: [{
+ *       uri: uri.toString(),
+ *       mimeType: 'application/json',
+ *       text: JSON.stringify({ userId: params.userId })
+ *     }]
+ *   })
+ * })
+ * ```
+ */
+export declare function registerResourceTemplate(this: ResourceTemplateServerContext, resourceTemplateDefinition: ResourceTemplateDefinition | ResourceTemplateDefinitionWithoutCallback, callback?: ReadResourceTemplateCallback): ResourceTemplateServerContext;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,oBAAoB,EACpB,4BAA4B,EAC5B,iCAAiC,EACjC,yCAAyC,EAC1C,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EACV,kBAAkB,EAEnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAIpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE;QACN,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE;YACR,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;SACjC,EACD,YAAY,EAAE,MAAM,OAAO,CAAC,kBAAkB,CAAC,GAC9C,IAAI,CAAC;KACT,CAAC;IACF,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,qBAAqB,EAC3B,kBAAkB,EAAE,kBAAkB,GAAG,iCAAiC,EAC1E,QAAQ,CAAC,EAAE,oBAAoB,GAC9B,qBAAqB,CA+EvB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE;QACN,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,gBAAgB,EAC1B,QAAQ,EAAE,GAAG,EACb,YAAY,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,CAAC,GACvC,IAAI,CAAC;KACT,CAAC;IACF,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC5E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,6BAA6B,EACnC,0BAA0B,EACtB,0BAA0B,GAC1B,yCAAyC,EAC7C,QAAQ,CAAC,EAAE,4BAA4B,GACtC,6BAA6B,CAkG/B"}

package/dist/src/server/resources/subscriptions.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Resource Subscription Management
+ *
+ * Handles subscription tracking and notifications for MCP resource updates.
+ * Implements the MCP resources/subscribe and resources/unsubscribe protocol.
+ */
+import type { McpServer as OfficialMcpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SessionData } from "../sessions/index.js";
+/**
+ * Subscription manager for tracking resource subscriptions across sessions
+ */
+export declare class ResourceSubscriptionManager {
+    /**
+     * Tracks resource subscriptions per session
+     * Map structure: uri -> Set<sessionId>
+     */
+    private subscriptions;
+    /**
+     * Register subscription handlers with an MCP server instance
+     *
+     * @param server - The native MCP server instance
+     * @param sessions - Map of active sessions
+     */
+    registerHandlers(server: OfficialMcpServer, sessions: Map<string, SessionData>): void;
+    /**
+     * Get session ID from request context or sessions map
+     *
+     * @param sessions - Map of active sessions
+     * @param server - The server instance to match against
+     * @returns The session ID, or undefined if not found
+     */
+    private getSessionIdFromContext;
+    /**
+     * Notify subscribed clients that a resource has been updated
+     *
+     * This method sends a `notifications/resources/updated` notification to all
+     * sessions that have subscribed to the specified resource URI.
+     *
+     * @param uri - The URI of the resource that changed
+     * @param sessions - Map of active sessions
+     * @returns Promise that resolves when all notifications have been sent
+     */
+    notifyResourceUpdated(uri: string, sessions: Map<string, SessionData>): Promise<void>;
+    /**
+     * Clean up resource subscriptions for a closed session
+     *
+     * This method is called automatically when a session is closed to remove
+     * all resource subscriptions associated with that session.
+     *
+     * @param sessionId - The session ID to clean up
+     */
+    cleanupSession(sessionId: string): void;
+}
+//# sourceMappingURL=subscriptions.d.ts.map

package/dist/src/server/resources/subscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../../../src/server/resources/subscriptions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,IAAI,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAK9F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;GAEG;AACH,qBAAa,2BAA2B;IACtC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAAkC;IAEvD;;;;;OAKG;IACI,gBAAgB,CACrB,MAAM,EAAE,iBAAiB,EACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GACjC,IAAI;IAgEP;;;;;;OAMG;IACH,OAAO,CAAC,uBAAuB;IAwB/B;;;;;;;;;OASG;IACU,qBAAqB,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IA6BhB;;;;;;;OAOG;IACI,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;CAW/C"}

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

@@ -0,0 +1,7 @@
+/**
+ * Roots management utilities
+ *
+ * This module provides functions for managing roots with the MCP server.
+ */
+export { onRootsChanged, listRoots } from "./roots-registration.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/roots/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/src/server/roots/roots-registration.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Roots Registration
+ *
+ * This module handles roots-related functionality for the MCP server.
+ * Roots represent the file system or project roots that clients have access to.
+ */
+/**
+ * Register a callback for when a client's roots change
+ *
+ * When a client sends a `notifications/roots/list_changed` notification,
+ * the server will automatically request the updated roots list and call
+ * this callback with the new roots.
+ *
+ * @param callback - Function called with the updated roots array
+ * @returns The server instance for method chaining
+ *
+ * @example
+ * ```typescript
+ * server.onRootsChanged(async (roots) => {
+ *   console.log("Client roots updated:", roots);
+ *   roots.forEach(root => {
+ *     console.log(`  - ${root.name || "unnamed"}: ${root.uri}`);
+ *   });
+ * });
+ * ```
+ */
+export declare function onRootsChanged(this: any, callback: (roots: Array<{
+    uri: string;
+    name?: string;
+}>) => void | Promise<void>): any;
+/**
+ * Request the current roots list from a specific client session
+ *
+ * This sends a `roots/list` request to the client and returns
+ * the list of roots the client has configured.
+ *
+ * @param sessionId - The session ID of the client to query
+ * @returns Array of roots, or null if the session doesn't exist or request fails
+ *
+ * @example
+ * ```typescript
+ * const sessions = server.getActiveSessions();
+ * if (sessions.length > 0) {
+ *   const roots = await server.listRoots(sessions[0]);
+ *   if (roots) {
+ *     console.log(`Client has ${roots.length} roots:`);
+ *     roots.forEach(r => console.log(`  - ${r.uri}`));
+ *   }
+ * }
+ * ```
+ */
+export declare function listRoots(this: any, sessionId: string): Promise<Array<{
+    uri: string;
+    name?: string;
+}> | null>;
+//# sourceMappingURL=roots-registration.d.ts.map

package/dist/src/server/roots/roots-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roots-registration.d.ts","sourceRoot":"","sources":["../../../../src/server/roots/roots-registration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,CACR,KAAK,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,KACzC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACxB,GAAG,CAGL;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,GAAG,EACT,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAAC,CA2BvD"}

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

@@ -0,0 +1,6 @@
+/**
+ * Session Management Exports
+ */
+export { type SessionData, startIdleCleanup } from "./session-manager.js";
+export { sendNotificationToAll, sendNotificationToSession, } from "./notifications.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,25 @@
+/**
+ * Session Notifications
+ *
+ * Utility functions for sending JSON-RPC notifications to MCP sessions.
+ */
+import type { SessionData } from "./session-manager.js";
+/**
+ * Send a notification to all connected sessions
+ *
+ * @param sessions - Map of active sessions
+ * @param method - The notification method name
+ * @param params - Optional parameters to include in the notification
+ */
+export declare function sendNotificationToAll(sessions: Map<string, SessionData>, method: string, params?: Record<string, unknown>): Promise<void>;
+/**
+ * Send a notification to a specific session
+ *
+ * @param sessions - Map of active sessions
+ * @param sessionId - The target session ID
+ * @param method - The notification method name
+ * @param params - Optional parameters to include in the notification
+ * @returns true if the notification was sent, false if session not found
+ */
+export declare function sendNotificationToSession(sessions: Map<string, SessionData>, sessionId: string, method: string, params?: Record<string, unknown>): Promise<boolean>;
+//# sourceMappingURL=notifications.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../../../src/server/sessions/notifications.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAClC,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAClC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAkBlB"}

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

@@ -0,0 +1,47 @@
+/**
+ * Session Manager
+ *
+ * Simplified session management for tracking active sessions.
+ * The native SDK transport handles session lifecycle internally.
+ */
+import type { Context } from "hono";
+/**
+ * Session data stored for each active MCP session
+ * Following official SDK pattern - each session has its own transport and server
+ */
+export interface SessionData {
+    /** Reference to this session's transport instance */
+    transport: any;
+    /** Reference to this session's server instance */
+    server?: any;
+    /** Timestamp of last activity for idle timeout tracking */
+    lastAccessedAt: number;
+    /** Hono context for this session's current request */
+    context?: Context;
+    /** Progress token for current tool call (if any) */
+    progressToken?: number;
+    /** Function to send notifications to the client */
+    sendNotification?: (notification: {
+        method: string;
+        params: Record<string, any>;
+    }) => Promise<void>;
+    /** Express-like response object for notifications */
+    expressRes?: any;
+    /** Hono context for direct response access */
+    honoContext?: Context;
+    /** Minimum log level for filtering log messages (RFC 5424 levels) */
+    logLevel?: string;
+}
+/**
+ * Start idle session cleanup interval
+ *
+ * Monitors sessions and removes them if they've been inactive for too long.
+ * Note: This only cleans up our session metadata. The transport manages
+ * its own session state.
+ *
+ * @param sessions - Map of active sessions
+ * @param idleTimeoutMs - Idle timeout in milliseconds
+ * @param mcpServerInstance - Optional MCP server instance for cleanup callbacks
+ */
+export declare function startIdleCleanup(sessions: Map<string, SessionData>, idleTimeoutMs: number, mcpServerInstance?: any): NodeJS.Timeout | undefined;
+//# sourceMappingURL=session-manager.d.ts.map