@posthog/mcp 0.10.9 → 0.11.1

package/README.md

@@ -67,6 +67,45 @@ if (body?.method === 'initialize' && !req.headers[MCP_SESSION_HEADER]) {
 
 Details: [docs/ARCHITECTURE.md §4](./docs/ARCHITECTURE.md).
 
+## MCP TypeScript SDK v2
+
+`instrument()` works on both SDK majors — `@modelcontextprotocol/sdk` v1 and
+`@modelcontextprotocol/{core,server,client}` v2 — and on both the high-level `McpServer` and the
+low-level `Server`. Shapes are detected at runtime, so neither major is a dependency here.
+
+### Reading request headers in a callback
+
+If your `identify`, `intentFallback`, `eventProperties` or `beforeSend` reads HTTP headers, it has
+to change. The two majors put the request in different places and in different shapes: v1 attaches
+a plain object at `extra.requestInfo.headers`, v2 attaches the WHATWG `Request` at `extra.http.req`,
+whose `headers` only answers to `.get()`. A v1-shaped read returns `undefined` on v2 — an
+`identify()` written that way returns `null` and every event goes anonymous.
+
+The SDK hands your callback whatever the MCP SDK handed it, unchanged; it does **not** fake a v1
+shape on v2, because a partially synthesised `requestInfo` is a more convincing lie than an absent
+one. Read headers through the exported helper instead, which handles both majors, lowercases keys,
+and duck-types `Headers` so it also works on edge runtimes:
+
+```ts
+import { getRequestHeaders } from '@posthog/mcp'
+
+identify: async (request, extra) => {
+  const auth = getRequestHeaders(extra)?.['authorization'] // v1 and v2
+  // ...
+}
+```
+
+### If you switched to `instrument(server.server)`
+
+Before v2 support landed, the compatibility gate rejected high-level v2 servers, and the usual
+workaround was to instrument the underlying low-level server. `instrument(server)` now works, so
+you can go back to the documented call.
+
+Whether the workaround costs you anything depends on your stack: instrumenting the low-level server
+skips the high-level tool registry, so tool descriptions and callback-level wrapping come only from
+what is advertised over `tools/list`. If your framework never calls `registerTool()` — `@rekog/mcp-nest`
+does not — the registry is empty and the two calls behave the same.
+
 ## Developing locally
 
 To test local changes in a consumer app (e.g. a dummy MCP server), symlink **both**

package/dist/extensions/capture.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/extensions/capture.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAGpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGxC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,QAAQ,EACpB,MAAM,EAAE,QAAQ,EAChB,kBAAkB,CAAC,EAAE,WAAW,GAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAoE3B"}
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/extensions/capture.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAGpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAGxC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,UAAU,EAAE,QAAQ,EACpB,MAAM,EAAE,QAAQ,EAChB,kBAAkB,CAAC,EAAE,WAAW,GAC/B,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CA0E3B"}

package/dist/extensions/capture.js

@@ -50,6 +50,8 @@ function captureEvent(server, eventInput, logger, requestAttribution) {
         serverVersion: sessionInfo.serverVersion,
         clientName: eventInput.clientName ?? sessionInfo.clientName,
         clientVersion: eventInput.clientVersion ?? sessionInfo.clientVersion,
+        clientUserAgent: eventInput.clientUserAgent,
+        vendorClient: eventInput.vendorClient,
         identifyActorGivenId: sessionInfo.identifyActorGivenId,
         identifyActorData: sessionInfo.identifyActorData,
         groups: sessionInfo.identifyActorGroups,

package/dist/extensions/capture.mjs

@@ -22,6 +22,8 @@ function captureEvent(server, eventInput, logger, requestAttribution) {
         serverVersion: sessionInfo.serverVersion,
         clientName: eventInput.clientName ?? sessionInfo.clientName,
         clientVersion: eventInput.clientVersion ?? sessionInfo.clientVersion,
+        clientUserAgent: eventInput.clientUserAgent,
+        vendorClient: eventInput.vendorClient,
         identifyActorGivenId: sessionInfo.identifyActorGivenId,
         identifyActorData: sessionInfo.identifyActorData,
         groups: sessionInfo.identifyActorGroups,

package/dist/extensions/compatibility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/extensions/compatibility.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE3C;;;;;;;;;;;GAWG;AAGH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAI9D;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,YAAY,GAAG;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAIpG;AAGD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,YAAY,CAExE;AAGD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,sBAAsB,CAgChH;AAsDD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAanE"}
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/extensions/compatibility.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAWrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAExC,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE3C;;;;;;;;;;;GAWG;AAEH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAI9D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,YAAY,GAAG;IAAE,MAAM,EAAE,YAAY,CAAA;CAAE,CAEpG;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,YAAY,CAExE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,GAAG,aAAa,GAAG,sBAAsB,CAiChH;AAyCD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAanE"}

package/dist/extensions/compatibility.js

@@ -24,20 +24,21 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    getMCPCompatibleErrorMessage: ()=>getMCPCompatibleErrorMessage,
-    isCompatibleServerType: ()=>isCompatibleServerType,
-    isHighLevelServer: ()=>isHighLevelServer,
     isLowLevelServer: ()=>isLowLevelServer,
-    logCompatibilityWarning: ()=>logCompatibilityWarning
+    isHighLevelServer: ()=>isHighLevelServer,
+    logCompatibilityWarning: ()=>logCompatibilityWarning,
+    isCompatibleServerType: ()=>isCompatibleServerType,
+    getMCPCompatibleErrorMessage: ()=>getMCPCompatibleErrorMessage
 });
+const external_detect_js_namespaceObject = require("./detect.js");
 function logCompatibilityWarning(logger) {
     logger('PostHog MCP analytics SDK Compatibility: This version only supports Model Context Protocol TypeScript SDK v1.11 and above. Please upgrade if using an older version.');
 }
 function isHighLevelServer(server) {
-    return !!server && 'object' == typeof server && 'server' in server && !!server.server && 'object' == typeof server.server;
+    return (0, external_detect_js_namespaceObject.hasNestedLowLevelServer)(server);
 }
 function isLowLevelServer(server) {
-    return !!server && 'object' == typeof server && !('server' in server);
+    return (0, external_detect_js_namespaceObject.isBareServerShape)(server);
 }
 function isCompatibleServerType(server, logger) {
     if (!server || 'object' != typeof server) {
@@ -45,13 +46,13 @@ function isCompatibleServerType(server, logger) {
         throw new Error("PostHog MCP analytics SDK compatibility error: Server must be an object. Ensure you're using MCP SDK v1.11 or higher.");
     }
     if (isHighLevelServer(server)) {
-        if (!server._registeredTools || 'object' != typeof server._registeredTools) {
+        if (!(0, external_detect_js_namespaceObject.hasToolRegistry)(server)) {
             logCompatibilityWarning(logger);
             throw new Error('PostHog MCP analytics SDK compatibility error: High-level server must have _registeredTools object. This requires MCP SDK v1.11 or higher.');
         }
-        if ('function' != typeof server.tool) {
+        if (!(0, external_detect_js_namespaceObject.canRegisterTools)(server)) {
             logCompatibilityWarning(logger);
-            throw new Error('PostHog MCP analytics SDK compatibility error: High-level server must have tool() method. This requires MCP SDK v1.11 or higher.');
+            throw new Error('PostHog MCP analytics SDK compatibility error: High-level server must have a registerTool() or tool() method. This requires MCP SDK v1.11 or higher.');
         }
         const targetServer = server.server;
         validateLowLevelServer(targetServer, logger);
@@ -65,24 +66,19 @@ function validateLowLevelServer(server, logger) {
         logCompatibilityWarning(logger);
         throw new Error("PostHog MCP analytics SDK compatibility error: Server must be an object. Ensure you're using MCP SDK v1.11 or higher.");
     }
-    const serverRecord = server;
-    if ('function' != typeof serverRecord.setRequestHandler) {
+    if (!(0, external_detect_js_namespaceObject.canSetRequestHandler)(server)) {
         logCompatibilityWarning(logger);
         throw new Error('PostHog MCP analytics SDK compatibility error: Server must have a setRequestHandler method. This requires MCP SDK v1.11 or higher.');
     }
-    if (!(serverRecord._requestHandlers && serverRecord._requestHandlers instanceof Map)) {
+    if (!(0, external_detect_js_namespaceObject.hasRequestHandlerMap)(server)) {
         logCompatibilityWarning(logger);
         throw new Error('PostHog MCP analytics SDK compatibility error: Server._requestHandlers is not accessible. This requires MCP SDK v1.11 or higher.');
     }
-    if ('function' != typeof serverRecord._requestHandlers.get) {
-        logCompatibilityWarning(logger);
-        throw new Error('PostHog MCP analytics SDK compatibility error: Server._requestHandlers must be a Map with a get method. This requires MCP SDK v1.11 or higher.');
-    }
-    if ('function' != typeof serverRecord.getClientVersion) {
+    if (!(0, external_detect_js_namespaceObject.hasClientVersionAccessor)(server)) {
         logCompatibilityWarning(logger);
         throw new Error('PostHog MCP analytics SDK compatibility error: Server.getClientVersion must be a function. This requires MCP SDK v1.11 or higher.');
     }
-    if (!serverRecord._serverInfo || 'object' != typeof serverRecord._serverInfo || !('name' in serverRecord._serverInfo)) {
+    if (!(0, external_detect_js_namespaceObject.hasServerInfo)(server)) {
         logCompatibilityWarning(logger);
         throw new Error('PostHog MCP analytics SDK compatibility error: Server._serverInfo is not accessible or missing name. This requires MCP SDK v1.11 or higher.');
     }

package/dist/extensions/compatibility.mjs

@@ -1,11 +1,12 @@
+import { canRegisterTools, canSetRequestHandler, hasClientVersionAccessor, hasNestedLowLevelServer, hasRequestHandlerMap, hasServerInfo, hasToolRegistry, isBareServerShape } from "./detect.mjs";
 function logCompatibilityWarning(logger) {
     logger('PostHog MCP analytics SDK Compatibility: This version only supports Model Context Protocol TypeScript SDK v1.11 and above. Please upgrade if using an older version.');
 }
 function isHighLevelServer(server) {
-    return !!server && 'object' == typeof server && 'server' in server && !!server.server && 'object' == typeof server.server;
+    return hasNestedLowLevelServer(server);
 }
 function isLowLevelServer(server) {
-    return !!server && 'object' == typeof server && !('server' in server);
+    return isBareServerShape(server);
 }
 function isCompatibleServerType(server, logger) {
     if (!server || 'object' != typeof server) {
@@ -13,13 +14,13 @@ function isCompatibleServerType(server, logger) {
         throw new Error("PostHog MCP analytics SDK compatibility error: Server must be an object. Ensure you're using MCP SDK v1.11 or higher.");
     }
     if (isHighLevelServer(server)) {
-        if (!server._registeredTools || 'object' != typeof server._registeredTools) {
+        if (!hasToolRegistry(server)) {
             logCompatibilityWarning(logger);
             throw new Error('PostHog MCP analytics SDK compatibility error: High-level server must have _registeredTools object. This requires MCP SDK v1.11 or higher.');
         }
-        if ('function' != typeof server.tool) {
+        if (!canRegisterTools(server)) {
             logCompatibilityWarning(logger);
-            throw new Error('PostHog MCP analytics SDK compatibility error: High-level server must have tool() method. This requires MCP SDK v1.11 or higher.');
+            throw new Error('PostHog MCP analytics SDK compatibility error: High-level server must have a registerTool() or tool() method. This requires MCP SDK v1.11 or higher.');
         }
         const targetServer = server.server;
         validateLowLevelServer(targetServer, logger);
@@ -33,24 +34,19 @@ function validateLowLevelServer(server, logger) {
         logCompatibilityWarning(logger);
         throw new Error("PostHog MCP analytics SDK compatibility error: Server must be an object. Ensure you're using MCP SDK v1.11 or higher.");
     }
-    const serverRecord = server;
-    if ('function' != typeof serverRecord.setRequestHandler) {
+    if (!canSetRequestHandler(server)) {
         logCompatibilityWarning(logger);
         throw new Error('PostHog MCP analytics SDK compatibility error: Server must have a setRequestHandler method. This requires MCP SDK v1.11 or higher.');
     }
-    if (!(serverRecord._requestHandlers && serverRecord._requestHandlers instanceof Map)) {
+    if (!hasRequestHandlerMap(server)) {
         logCompatibilityWarning(logger);
         throw new Error('PostHog MCP analytics SDK compatibility error: Server._requestHandlers is not accessible. This requires MCP SDK v1.11 or higher.');
     }
-    if ('function' != typeof serverRecord._requestHandlers.get) {
-        logCompatibilityWarning(logger);
-        throw new Error('PostHog MCP analytics SDK compatibility error: Server._requestHandlers must be a Map with a get method. This requires MCP SDK v1.11 or higher.');
-    }
-    if ('function' != typeof serverRecord.getClientVersion) {
+    if (!hasClientVersionAccessor(server)) {
         logCompatibilityWarning(logger);
         throw new Error('PostHog MCP analytics SDK compatibility error: Server.getClientVersion must be a function. This requires MCP SDK v1.11 or higher.');
     }
-    if (!serverRecord._serverInfo || 'object' != typeof serverRecord._serverInfo || !('name' in serverRecord._serverInfo)) {
+    if (!hasServerInfo(server)) {
         logCompatibilityWarning(logger);
         throw new Error('PostHog MCP analytics SDK compatibility error: Server._serverInfo is not accessible or missing name. This requires MCP SDK v1.11 or higher.');
     }

package/dist/extensions/constants.d.ts

@@ -19,6 +19,7 @@ export declare const PostHogMCPAnalyticsEvent: {
 export type PostHogMCPAnalyticsEvent = (typeof PostHogMCPAnalyticsEvent)[keyof typeof PostHogMCPAnalyticsEvent];
 export declare const PostHogMCPAnalyticsProperty: {
     readonly ClientName: "$mcp_client_name";
+    readonly ClientUserAgent: "$mcp_client_user_agent";
     readonly ClientVersion: "$mcp_client_version";
     readonly ConversationId: "$mcp_conversation_id";
     readonly DurationMs: "$mcp_duration_ms";
@@ -39,6 +40,7 @@ export declare const PostHogMCPAnalyticsProperty: {
     readonly ToolCategory: "$mcp_tool_category";
     readonly ToolDescription: "$mcp_tool_description";
     readonly ToolName: "$mcp_tool_name";
+    readonly VendorClient: "$mcp_vendor_client";
 };
 export type PostHogMCPAnalyticsProperty = (typeof PostHogMCPAnalyticsProperty)[keyof typeof PostHogMCPAnalyticsProperty];
 //# sourceMappingURL=constants.d.ts.map

package/dist/extensions/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/extensions/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,6BAA6B,KAAK,CAAA;AAE/C,eAAO,MAAM,qCAAqC,2hBAAyhB,CAAA;AAE3kB,eAAO,MAAM,mCAAmC,4LACsI,CAAA;AAEtL,eAAO,MAAM,4BAA4B,0BAA0B,CAAA;AAMnE,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AAItD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;CAY3B,CAAA;AAEV,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAA;AAE/G,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;CAsB9B,CAAA;AAEV,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAA"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/extensions/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,6BAA6B,KAAK,CAAA;AAE/C,eAAO,MAAM,qCAAqC,2hBAAyhB,CAAA;AAE3kB,eAAO,MAAM,mCAAmC,4LACsI,CAAA;AAEtL,eAAO,MAAM,4BAA4B,0BAA0B,CAAA;AAMnE,eAAO,MAAM,oBAAoB,qBAAqB,CAAA;AAItD,eAAO,MAAM,wBAAwB;;;;;;;;;;;;CAY3B,CAAA;AAEV,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAA;AAE/G,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;CAwB9B,CAAA;AAEV,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAA"}

package/dist/extensions/constants.js

@@ -52,6 +52,7 @@ const PostHogMCPAnalyticsEvent = {
 };
 const PostHogMCPAnalyticsProperty = {
     ClientName: '$mcp_client_name',
+    ClientUserAgent: '$mcp_client_user_agent',
     ClientVersion: '$mcp_client_version',
     ConversationId: '$mcp_conversation_id',
     DurationMs: '$mcp_duration_ms',
@@ -71,7 +72,8 @@ const PostHogMCPAnalyticsProperty = {
     Source: '$mcp_source',
     ToolCategory: '$mcp_tool_category',
     ToolDescription: "$mcp_tool_description",
-    ToolName: '$mcp_tool_name'
+    ToolName: '$mcp_tool_name',
+    VendorClient: '$mcp_vendor_client'
 };
 exports.DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = __webpack_exports__.DEFAULT_CONTEXT_PARAMETER_DESCRIPTION;
 exports.DEFAULT_CONVERSATION_ID_DESCRIPTION = __webpack_exports__.DEFAULT_CONVERSATION_ID_DESCRIPTION;

package/dist/extensions/constants.mjs

@@ -18,6 +18,7 @@ const PostHogMCPAnalyticsEvent = {
 };
 const PostHogMCPAnalyticsProperty = {
     ClientName: '$mcp_client_name',
+    ClientUserAgent: '$mcp_client_user_agent',
     ClientVersion: '$mcp_client_version',
     ConversationId: '$mcp_conversation_id',
     DurationMs: '$mcp_duration_ms',
@@ -37,6 +38,7 @@ const PostHogMCPAnalyticsProperty = {
     Source: '$mcp_source',
     ToolCategory: '$mcp_tool_category',
     ToolDescription: "$mcp_tool_description",
-    ToolName: '$mcp_tool_name'
+    ToolName: '$mcp_tool_name',
+    VendorClient: '$mcp_vendor_client'
 };
 export { DEFAULT_CONTEXT_PARAMETER_DESCRIPTION, DEFAULT_CONVERSATION_ID_DESCRIPTION, INACTIVITY_TIMEOUT_IN_MINUTES, POSTHOG_MCP_ANALYTICS_SOURCE, POSTHOG_MCP_LIB_NAME, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty };

package/dist/extensions/context-parameters.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-parameters.d.ts","sourceRoot":"","sources":["../../src/extensions/context-parameters.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7C,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,6BAA6B,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,GAAG,OAAO,CAEjF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAEjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,SAAS,qBAAqB,EAC3E,IAAI,EAAE,KAAK,EACX,0BAA0B,CAAC,EAAE,MAAM,EACnC,MAAM,GAAE,QAAc,GACrB,KAAK,CA6DP;AAED,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,qBAAqB,EAC5E,KAAK,EAAE,KAAK,EAAE,EACd,0BAA0B,CAAC,EAAE,MAAM,EACnC,MAAM,GAAE,QAAc,GACrB,KAAK,EAAE,CAET"}
+{"version":3,"file":"context-parameters.d.ts","sourceRoot":"","sources":["../../src/extensions/context-parameters.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AACnD,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7C,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,6BAA6B,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,GAAG,OAAO,CAEjF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,GAAG,MAAM,GAAG,SAAS,CAEjG;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,SAAS,qBAAqB,EAC3E,IAAI,EAAE,KAAK,EACX,0BAA0B,CAAC,EAAE,MAAM,EACnC,MAAM,GAAE,QAAc,GACrB,KAAK,CAqDP;AAED,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,qBAAqB,EAC5E,KAAK,EAAE,KAAK,EAAE,EACd,0BAA0B,CAAC,EAAE,MAAM,EACnC,MAAM,GAAE,QAAc,GACrB,KAAK,EAAE,CAET"}

package/dist/extensions/conversation-id.d.ts

@@ -31,20 +31,9 @@ export type ConversationIdResolution = {
  * derivation is deterministic so that two pods agree — which also means two
  * *callers* sending the same string land in the same session. The strings agents
  * invent are not random (`conv-1`, `1`, `session`), so trusting them verbatim
- * would silently merge unrelated conversations, potentially across users.
- *
- * A compliant agent echoes the uuidv7 we minted and is unaffected. Anything else
- * is treated exactly as if the handle were absent: mint, and prompt back. Shape
+ * would silently merge unrelated conversations, potentially across users. Shape
  * rather than a registry of issued ids, because a per-request server has no
- * memory of what it minted.
- *
- * This narrows the problem, it does not prove provenance: a caller supplying a
- * well-formed uuidv7 is trusted, so two that pick the *same* one still merge. That
- * residue is far smaller than the case it replaces — an agent ignoring the
- * parameter description reaches for `conv-1` or `1`, not a conforming uuidv7 — and
- * closing it needs a signed handle, i.e. a secret shared by every pod. Worth doing
- * if this ever anchors something security-bearing; `$session_id` is an analytics
- * grouping key, so it does not today.
+ * memory of what it minted. Residual risk and why it's accepted: ADR-0004.
  */
 export declare function resolveConversationId(enabled: boolean, args: unknown): ConversationIdResolution;
 /**

package/dist/extensions/conversation-id.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversation-id.d.ts","sourceRoot":"","sources":["../../src/extensions/conversation-id.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7C,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAE3D,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,6BAA6B,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,4BAA4B,EAChF,IAAI,EAAE,KAAK,EACX,MAAM,GAAE,QAAc,GACrB,KAAK,CA4CP;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,4BAA4B,EACjF,KAAK,EAAE,KAAK,EAAE,EACd,MAAM,GAAE,QAAc,GACrB,KAAK,EAAE,CAET;AAQD,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACrD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAa/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAK1E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUvE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAM1D;AAED,wBAAgB,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAKA;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAS/F"}
+{"version":3,"file":"conversation-id.d.ts","sourceRoot":"","sources":["../../src/extensions/conversation-id.ts"],"names":[],"mappings":"AAMA,OAAO,EAGL,KAAK,6BAA6B,EACnC,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7C,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAE3D,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,6BAA6B,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,4BAA4B,EAChF,IAAI,EAAE,KAAK,EACX,MAAM,GAAE,QAAc,GACrB,KAAK,CA4CP;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,4BAA4B,EACjF,KAAK,EAAE,KAAK,EAAE,EACd,MAAM,GAAE,QAAc,GACrB,KAAK,EAAE,CAET;AAQD,MAAM,MAAM,wBAAwB,GAChC;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACrD;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5C;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,wBAAwB,CAY/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAK1E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUvE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAM1D;AAED,wBAAgB,6BAA6B,CAAC,cAAc,EAAE,MAAM,GAAG;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb,CAKA;AAED,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAS/F"}

package/dist/extensions/detect.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Structural feature probes.
+ *
+ * Every question about the shape of a server object is answered here, by
+ * duck-typing the object in front of us — never by reading a package version or
+ * a protocol constant. Two reasons this is a rule and not a preference:
+ *
+ * - The two SDK majors expose the same capability under different names (v1's
+ *   `.tool()` vs v2's `.registerTool()`), so "which SDK is installed" answers a
+ *   different question than "can this object register a tool".
+ * - A single v2 server serves both protocol eras, request by request, so no
+ *   module-level constant describes it. v2's exported `LATEST_PROTOCOL_VERSION`
+ *   is `2025-11-25`.
+ *
+ * Nothing here imports `@modelcontextprotocol/*`; that boundary is pinned by
+ * `sdk-import-boundary.test.ts`.
+ */
+type UnknownRecord = Record<string, unknown>;
+/** A high-level `McpServer` wrapper: it holds the low-level server on `.server`. */
+export declare function hasNestedLowLevelServer(server: unknown): server is UnknownRecord & {
+    server: UnknownRecord;
+};
+/** No `.server` property, so the object is itself the low-level `Server`. */
+export declare function isBareServerShape(server: unknown): boolean;
+/** The high-level registry we read tool metadata from and wrap callbacks in. */
+export declare function hasToolRegistry(server: unknown): boolean;
+/**
+ * The object can register a tool.
+ *
+ * v1 offers both `tool()` and `registerTool()`; v2 dropped the deprecated
+ * `tool()` and keeps only `registerTool()`. Requiring `tool()` specifically is
+ * what made `instrument()` reject every v2 high-level server — and, because
+ * `instrument()` swallows compatibility errors, reject it silently.
+ */
+export declare function canRegisterTools(server: unknown): boolean;
+/** Handler registration, which we patch to wrap late registrations. */
+export declare function canSetRequestHandler(server: unknown): boolean;
+/** The live handler map we read and write directly. A real `Map` on both majors. */
+export declare function hasRequestHandlerMap(server: unknown): boolean;
+/** `getClientVersion()` — still present on v2, and a link in B1's identity chain. */
+export declare function hasClientVersionAccessor(server: unknown): boolean;
+/** `_serverInfo`, which names the server on every event. */
+export declare function hasServerInfo(server: unknown): boolean;
+export {};
+//# sourceMappingURL=detect.d.ts.map

package/dist/extensions/detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.d.ts","sourceRoot":"","sources":["../../src/extensions/detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,KAAK,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAU5C,oFAAoF;AACpF,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,IAAI,aAAa,GAAG;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,CAG5G;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAG1D;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAExD;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAEzD;AAED,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAE7D;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAG7D;AAED,qFAAqF;AACrF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAEjE;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAGtD"}

package/dist/extensions/detect.js

@@ -0,0 +1,90 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    canRegisterTools: ()=>canRegisterTools,
+    canSetRequestHandler: ()=>canSetRequestHandler,
+    hasClientVersionAccessor: ()=>hasClientVersionAccessor,
+    hasNestedLowLevelServer: ()=>hasNestedLowLevelServer,
+    hasRequestHandlerMap: ()=>hasRequestHandlerMap,
+    hasServerInfo: ()=>hasServerInfo,
+    hasToolRegistry: ()=>hasToolRegistry,
+    isBareServerShape: ()=>isBareServerShape
+});
+function asRecord(value) {
+    return value && 'object' == typeof value ? value : void 0;
+}
+function hasMethod(value, key) {
+    return 'function' == typeof asRecord(value)?.[key];
+}
+function hasNestedLowLevelServer(server) {
+    const record = asRecord(server);
+    return !!record && 'server' in record && !!asRecord(record.server);
+}
+function isBareServerShape(server) {
+    const record = asRecord(server);
+    return !!record && !('server' in record);
+}
+function hasToolRegistry(server) {
+    return !!asRecord(asRecord(server)?._registeredTools);
+}
+function canRegisterTools(server) {
+    return hasMethod(server, 'registerTool') || hasMethod(server, 'tool');
+}
+function canSetRequestHandler(server) {
+    return hasMethod(server, 'setRequestHandler');
+}
+function hasRequestHandlerMap(server) {
+    const handlers = asRecord(server)?._requestHandlers;
+    return handlers instanceof Map && 'function' == typeof handlers.get;
+}
+function hasClientVersionAccessor(server) {
+    return hasMethod(server, 'getClientVersion');
+}
+function hasServerInfo(server) {
+    const info = asRecord(asRecord(server)?._serverInfo);
+    return !!info && 'name' in info;
+}
+exports.canRegisterTools = __webpack_exports__.canRegisterTools;
+exports.canSetRequestHandler = __webpack_exports__.canSetRequestHandler;
+exports.hasClientVersionAccessor = __webpack_exports__.hasClientVersionAccessor;
+exports.hasNestedLowLevelServer = __webpack_exports__.hasNestedLowLevelServer;
+exports.hasRequestHandlerMap = __webpack_exports__.hasRequestHandlerMap;
+exports.hasServerInfo = __webpack_exports__.hasServerInfo;
+exports.hasToolRegistry = __webpack_exports__.hasToolRegistry;
+exports.isBareServerShape = __webpack_exports__.isBareServerShape;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "canRegisterTools",
+    "canSetRequestHandler",
+    "hasClientVersionAccessor",
+    "hasNestedLowLevelServer",
+    "hasRequestHandlerMap",
+    "hasServerInfo",
+    "hasToolRegistry",
+    "isBareServerShape"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/extensions/detect.mjs

@@ -0,0 +1,35 @@
+function asRecord(value) {
+    return value && 'object' == typeof value ? value : void 0;
+}
+function hasMethod(value, key) {
+    return 'function' == typeof asRecord(value)?.[key];
+}
+function hasNestedLowLevelServer(server) {
+    const record = asRecord(server);
+    return !!record && 'server' in record && !!asRecord(record.server);
+}
+function isBareServerShape(server) {
+    const record = asRecord(server);
+    return !!record && !('server' in record);
+}
+function hasToolRegistry(server) {
+    return !!asRecord(asRecord(server)?._registeredTools);
+}
+function canRegisterTools(server) {
+    return hasMethod(server, 'registerTool') || hasMethod(server, 'tool');
+}
+function canSetRequestHandler(server) {
+    return hasMethod(server, 'setRequestHandler');
+}
+function hasRequestHandlerMap(server) {
+    const handlers = asRecord(server)?._requestHandlers;
+    return handlers instanceof Map && 'function' == typeof handlers.get;
+}
+function hasClientVersionAccessor(server) {
+    return hasMethod(server, 'getClientVersion');
+}
+function hasServerInfo(server) {
+    const info = asRecord(asRecord(server)?._serverInfo);
+    return !!info && 'name' in info;
+}
+export { canRegisterTools, canSetRequestHandler, hasClientVersionAccessor, hasNestedLowLevelServer, hasRequestHandlerMap, hasServerInfo, hasToolRegistry, isBareServerShape };

package/dist/extensions/headers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * The single place this package reads an HTTP request header.
+ *
+ * The MCP SDK hands us `IsomorphicHeaders` — a plain
+ * `Record<string, string | string[] | undefined>`, not a `Headers` instance — so
+ * values come out by bracket access rather than `.get()`. MCP SDK v2 plans to
+ * pass a real `Headers` object instead; funnelling every read through here keeps
+ * that migration a one-function change instead of a hunt for bracket lookups.
+ */
+/**
+ * Reads one header value out of an `IsomorphicHeaders` bag. `name` must be
+ * lower-cased: the HTTP transports build the bag with
+ * `Object.fromEntries(req.headers.entries())` and the Fetch spec lower-cases
+ * header names. A hand-rolled transport can still hand us mixed-case keys, so a
+ * case-insensitive scan backs up the direct lookup.
+ *
+ * Repeated headers arrive as an array — we take the first entry, since every
+ * header we read is single-valued by definition. Returns `undefined` for a
+ * missing, non-string, or blank value, and never throws: a malformed header from
+ * an untrusted client must not break the request it rode in on.
+ */
+export declare function readHeaderValue(headers: unknown, name: string): string | undefined;
+/**
+ * Coerces one raw header value into a clean string, or `undefined`.
+ *
+ * Exported so the custom-dispatcher path can apply the same rules to values a host
+ * read off the request itself. Without it the two integration paths emit different
+ * properties for the *same* request: a whitespace-only header would survive as a junk
+ * value, and a repeated header would reach the wire as an array, because the
+ * downstream length cap passes non-strings through untouched.
+ */
+export declare function normalizeHeaderString(value: unknown): string | undefined;
+//# sourceMappingURL=headers.d.ts.map

package/dist/extensions/headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../../src/extensions/headers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAWlF;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAOxE"}

package/dist/extensions/headers.js

@@ -0,0 +1,54 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    normalizeHeaderString: ()=>normalizeHeaderString,
+    readHeaderValue: ()=>readHeaderValue
+});
+function readHeaderValue(headers, name) {
+    if (!headers || 'object' != typeof headers) return;
+    const record = headers;
+    let value = record[name];
+    if (void 0 === value) {
+        const key = Object.keys(record).find((k)=>k.toLowerCase() === name);
+        value = void 0 === key ? void 0 : record[key];
+    }
+    return normalizeHeaderString(value);
+}
+function normalizeHeaderString(value) {
+    const first = Array.isArray(value) ? value[0] : value;
+    if ('string' != typeof first) return;
+    const trimmed = first.trim();
+    return trimmed.length > 0 ? trimmed : void 0;
+}
+exports.normalizeHeaderString = __webpack_exports__.normalizeHeaderString;
+exports.readHeaderValue = __webpack_exports__.readHeaderValue;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "normalizeHeaderString",
+    "readHeaderValue"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/extensions/headers.mjs

@@ -0,0 +1,17 @@
+function readHeaderValue(headers, name) {
+    if (!headers || 'object' != typeof headers) return;
+    const record = headers;
+    let value = record[name];
+    if (void 0 === value) {
+        const key = Object.keys(record).find((k)=>k.toLowerCase() === name);
+        value = void 0 === key ? void 0 : record[key];
+    }
+    return normalizeHeaderString(value);
+}
+function normalizeHeaderString(value) {
+    const first = Array.isArray(value) ? value[0] : value;
+    if ('string' != typeof first) return;
+    const trimmed = first.trim();
+    return trimmed.length > 0 ? trimmed : void 0;
+}
+export { normalizeHeaderString, readHeaderValue };

package/dist/extensions/instrument-highlevel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrument-highlevel.d.ts","sourceRoot":"","sources":["../../src/extensions/instrument-highlevel.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,sBAAsB,EAIvB,MAAM,UAAU,CAAA;AASjB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAgQxC,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CA2BhG"}
+{"version":3,"file":"instrument-highlevel.d.ts","sourceRoot":"","sources":["../../src/extensions/instrument-highlevel.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,sBAAsB,EAIvB,MAAM,UAAU,CAAA;AASjB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAgQxC,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CA0BhG"}

package/dist/extensions/instrument-lowlevel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"instrument-lowlevel.d.ts","sourceRoot":"","sources":["../../src/extensions/instrument-lowlevel.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAiD,aAAa,EAAE,MAAM,UAAU,CAAA;AAG5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAmBxC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CA0BtF"}
+{"version":3,"file":"instrument-lowlevel.d.ts","sourceRoot":"","sources":["../../src/extensions/instrument-lowlevel.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAiD,aAAa,EAAE,MAAM,UAAU,CAAA;AAG5F,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAmBxC;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,QAAQ,GAAG,IAAI,CAyBtF"}

package/dist/extensions/instrumentation.d.ts

@@ -77,6 +77,13 @@ export type HandlerPatch = (server: MCPServerLike, originalHandler: MCPRequestHa
  *   the shipped bundle.
  */
 export declare function registerFallbackRequestHandler(server: MCPServerLike, handlerName: string, fallbackHandler: MCPRequestHandler, patch: HandlerPatch): void;
+/**
+ * Applies the `patches` (keyed by method, e.g. `initialize`, `tools/list`) to the
+ * handlers already registered, and patches `setRequestHandler` so matching
+ * handlers registered later are patched too. The latter is what makes adapters
+ * that register handlers post-construction work — e.g. `@rekog/mcp-nest` hands a
+ * bare server to instrument() and only then registers its handlers.
+ */
 export declare function patchRequestHandlers(server: MCPServerLike, patches: Record<string, HandlerPatch>): void;
 /**
  * Checks the server's raw listing for a real owner of a candidate virtual tool.