@posthog/mcp 0.10.4 → 0.10.5

package/dist/extensions/instrumentation.mjs

@@ -7,7 +7,6 @@ import { MCPAnalyticsEventType } from "./event-types.mjs";
 import { captureException } from "./exceptions.mjs";
 import { resolveToolCallIntent, setEventIntent, setExplicitContextIntent } from "./intent.mjs";
 import { getServerTrackingData, handleIdentify, setServerTrackingData } from "./internal.mjs";
-import { log } from "./logger.mjs";
 import { buildCapturedMcpParameters } from "./mcp-payloads.mjs";
 import { getLiteralValue, getObjectShape } from "./mcp-sdk-compat.mjs";
 import { getSessionId, newSessionId } from "./session.mjs";
@@ -26,11 +25,11 @@ async function captureToolCall(params) {
     try {
         result = await execute(downstreamRequest);
     } catch (error) {
-        publishFailedToolEvent(server, event, error, startTime, conversation);
+        publishFailedToolEvent(server, event, error, startTime, conversation, data.logger);
         throw error;
     }
     const finalResult = applyConversationPromptBack(event, result, conversation);
-    publishSuccessfulToolEvent(server, event, finalResult, startTime, takeCapturedError);
+    publishSuccessfulToolEvent(server, event, finalResult, startTime, data.logger, takeCapturedError);
     return finalResult;
 }
 function getActiveAnalyticsParameterOwnership(data, toolName, override) {
@@ -73,7 +72,7 @@ async function prepareToolCallEvent(server, data, request, downstreamRequest, ex
         setEventIntent(event, await resolveToolCallIntent(data, request, ownership.context, extra));
         return event;
     } catch (error) {
-        log(`Warning: PostHog MCP analytics instrumentation failed for tool ${request.params?.name}, the tool will still run - ${error}`);
+        data.logger(`Warning: PostHog MCP analytics instrumentation failed for tool ${request.params?.name}, the tool will still run - ${error}`);
         return null;
     }
 }
@@ -83,7 +82,7 @@ function applyConversationPromptBack(event, result, conversation) {
     if (event) event.conversationId = void 0;
     return result;
 }
-function publishSuccessfulToolEvent(server, event, result, startTime, takeCapturedError) {
+function publishSuccessfulToolEvent(server, event, result, startTime, logger, takeCapturedError) {
     if (!event) return;
     try {
         if (isToolResultError(result)) {
@@ -93,21 +92,21 @@ function publishSuccessfulToolEvent(server, event, result, startTime, takeCaptur
         } else event.isError = false;
         event.response = result;
         event.duration = Date.now() - startTime.getTime();
-        captureEvent(server, event);
+        captureEvent(server, event, logger);
     } catch (error) {
-        log(`Warning: PostHog MCP analytics failed to publish tool event - ${error}`);
+        logger(`Warning: PostHog MCP analytics failed to publish tool event - ${error}`);
     }
 }
-function publishFailedToolEvent(server, event, error, startTime, conversation) {
+function publishFailedToolEvent(server, event, error, startTime, conversation, logger) {
     if (!event) return;
     try {
         if (conversation.minted) event.conversationId = void 0;
         event.isError = true;
         event.error = captureException(error);
         event.duration = Date.now() - startTime.getTime();
-        captureEvent(server, event);
+        captureEvent(server, event, logger);
     } catch (publishError) {
-        log(`Warning: PostHog MCP analytics failed to publish failed tool event - ${publishError}`);
+        logger(`Warning: PostHog MCP analytics failed to publish failed tool event - ${publishError}`);
     }
 }
 function patchRequestHandlers(server, patches) {
@@ -124,7 +123,7 @@ function patchRequestHandlers(server, patches) {
         return originalSetRequestHandler(requestSchema, (request, extra)=>patch(server, originalHandler, request, extra));
     };
 }
-async function handleListToolsRequest(server, originalListToolsHandler, request, extra) {
+async function handleListToolsRequest(server, originalListToolsHandler, request, extra, logger) {
     const data = getServerTrackingData(server);
     const startTime = new Date();
     const event = {
@@ -135,19 +134,19 @@ async function handleListToolsRequest(server, originalListToolsHandler, request,
     };
     stampMetaClientInfo(event, request);
     if (data) await applyResolvedMetadata(event, data, request, extra);
-    const tools = await getTracedToolsList(server, originalListToolsHandler, request, extra, event);
+    const tools = await getTracedToolsList(server, originalListToolsHandler, request, extra, event, logger);
     if (!data) {
-        log('Warning: PostHog MCP analytics is unable to find server tracking data. Please ensure you have called instrument(server, options) before using tool calls.');
+        logger('Warning: PostHog MCP analytics is unable to find server tracking data. Please ensure you have called instrument(server, options) before using tool calls.');
         return {
             tools
         };
     }
     if (0 === tools.length) {
-        log('Warning: No tools found in the original list. This is likely due to the tools not being registered before PostHog MCP analytics.instrument().');
+        data.logger('Warning: No tools found in the original list. This is likely due to the tools not being registered before PostHog MCP analytics.instrument().');
         event.error = captureException('No tools were sent to MCP client.');
         event.isError = true;
         event.duration = Date.now() - startTime.getTime();
-        captureEvent(server, event);
+        captureEvent(server, event, data.logger);
         return {
             tools
         };
@@ -158,7 +157,7 @@ async function handleListToolsRequest(server, originalListToolsHandler, request,
     event.listedToolNames = collectListedToolNames(tools);
     event.isError = false;
     event.duration = Date.now() - startTime.getTime();
-    captureEvent(server, event);
+    captureEvent(server, event, data.logger);
     return {
         tools
     };
@@ -171,14 +170,14 @@ function collectListedToolNames(tools) {
     const names = tools.map((tool)=>tool?.name).filter((name)=>'string' == typeof name);
     return names.length > 0 ? names : void 0;
 }
-async function getTracedToolsList(server, originalListToolsHandler, request, extra, event) {
+async function getTracedToolsList(server, originalListToolsHandler, request, extra, event, logger) {
     try {
         const data = getServerTrackingData(server);
         const originalResponse = await originalListToolsHandler(request, extra);
         let tools = originalResponse.tools || [];
         if (data) cacheToolAnalyticsParameterOwnership(data.toolAnalyticsParameterOwnership, tools);
-        if (data && isContextEnabled(data.options.context)) tools = addContextParameterToTools(tools, getContextDescription(data.options.context));
-        if (data?.options.enableConversationId) tools = addConversationIdToTools(tools, resolveMissingCapabilityToolName(data.options));
+        if (data && isContextEnabled(data.options.context)) tools = addContextParameterToTools(tools, getContextDescription(data.options.context), data.logger);
+        if (data?.options.enableConversationId) tools = addConversationIdToTools(tools, resolveMissingCapabilityToolName(data.options), data.logger);
         if (data?.options.reportMissing) {
             const missingToolName = resolveMissingCapabilityToolName(data.options);
             const alreadyPresent = tools.some((tool)=>tool?.name === missingToolName);
@@ -190,11 +189,11 @@ async function getTracedToolsList(server, originalListToolsHandler, request, ext
         }
         return tools;
     } catch (error) {
-        log(`Warning: Original list tools handler failed, this suggests an error PostHog MCP analytics did not cause - ${error}`);
+        logger(`Warning: Original list tools handler failed, this suggests an error PostHog MCP analytics did not cause - ${error}`);
         event.error = captureException(error);
         event.isError = true;
         event.duration = event.timestamp ? Date.now() - event.timestamp.getTime() : 0;
-        captureEvent(server, event);
+        captureEvent(server, event, logger);
         throw error;
     }
 }
@@ -239,7 +238,7 @@ function mintStatelessSessionOnInitialize(server, data, request, extra) {
         setServerTrackingData(server, data);
         return sessionId;
     } catch (error) {
-        log(`Warning: PostHog MCP analytics failed to mint a stateless session id - ${error}`);
+        data.logger(`Warning: PostHog MCP analytics failed to mint a stateless session id - ${error}`);
         return;
     }
 }
@@ -255,7 +254,7 @@ function upgradeMintedTokenToNegotiated(server, data, mintedSessionId, negotiate
         });
         writeSessionIdToTransport(transport, token);
     } catch (error) {
-        log(`Warning: PostHog MCP analytics failed to upgrade the stateless session token - ${error}`);
+        data.logger(`Warning: PostHog MCP analytics failed to upgrade the stateless session token - ${error}`);
     }
 }
 function readInitializeClientInfo(request) {
@@ -267,10 +266,10 @@ function readInitializeClientInfo(request) {
         version: 'string' == typeof version ? version : void 0
     };
 }
-async function handleInitializeRequest(server, originalInitializeHandler, request, extra) {
+async function handleInitializeRequest(server, originalInitializeHandler, request, extra, logger) {
     const data = getServerTrackingData(server);
     if (!data) {
-        log('Warning: PostHog MCP analytics is unable to find server tracking data. Please ensure you have called instrument(server, options) before using tool calls.');
+        logger('Warning: PostHog MCP analytics is unable to find server tracking data. Please ensure you have called instrument(server, options) before using tool calls.');
         return await originalInitializeHandler(request, extra);
     }
     const mintedSessionId = mintStatelessSessionOnInitialize(server, data, request, extra);
@@ -292,7 +291,7 @@ async function handleInitializeRequest(server, originalInitializeHandler, reques
     data.sessionInfo.protocolVersion = negotiatedProtocolVersion;
     setServerTrackingData(server, data);
     if (mintedSessionId) upgradeMintedTokenToNegotiated(server, data, mintedSessionId, negotiatedProtocolVersion);
-    captureEvent(server, event);
+    captureEvent(server, event, data.logger);
     return result;
 }
 function readProtocolVersion(result, request) {

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

@@ -1 +1 @@
-{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/extensions/intent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,QAAQ,EACT,MAAM,UAAU,CAAA;AAIjB,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,wBAAwB,CAAA;CACjC;AAkCD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,cAAc,EACvB,oBAAoB,EAAE,OAAO,EAC7B,KAAK,CAAC,EAAE,6BAA6B,GACpC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAYhC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAO3F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ/E"}
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/extensions/intent.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,wBAAwB,EACxB,cAAc,EACd,QAAQ,EACT,MAAM,UAAU,CAAA;AAGjB,UAAU,cAAc;IACtB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,wBAAwB,CAAA;CACjC;AAkCD,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,cAAc,EACvB,oBAAoB,EAAE,OAAO,EAC7B,KAAK,CAAC,EAAE,6BAA6B,GACpC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAYhC;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAO3F;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ/E"}

package/dist/extensions/intent.js

@@ -29,7 +29,6 @@ __webpack_require__.d(__webpack_exports__, {
     setEventIntent: ()=>setEventIntent
 });
 const external_context_parameters_js_namespaceObject = require("./context-parameters.js");
-const external_logger_js_namespaceObject = require("./logger.js");
 function getContextArgument(request) {
     const context = request.params?.arguments?.context;
     return 'string' == typeof context && context.trim() ? context : void 0;
@@ -48,7 +47,7 @@ async function runIntentFallback(data, request, extra) {
             source: 'inferred'
         } : null;
     } catch (error) {
-        (0, external_logger_js_namespaceObject.log)(`intentFallback callback error: ${error}`);
+        data.logger(`intentFallback callback error: ${error}`);
         return null;
     }
 }

package/dist/extensions/intent.mjs

@@ -1,5 +1,4 @@
 import { isContextEnabled } from "./context-parameters.mjs";
-import { log } from "./logger.mjs";
 function getContextArgument(request) {
     const context = request.params?.arguments?.context;
     return 'string' == typeof context && context.trim() ? context : void 0;
@@ -18,7 +17,7 @@ async function runIntentFallback(data, request, extra) {
             source: 'inferred'
         } : null;
     } catch (error) {
-        log(`intentFallback callback error: ${error}`);
+        data.logger(`intentFallback callback error: ${error}`);
         return null;
     }
 }

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

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/extensions/internal.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,cAAc,EACd,aAAa,EAEb,YAAY,EACb,MAAM,UAAU,CAAA;AAMjB;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAErB,OAAO,SAAO;IAI1B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAWhD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAapD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,IAAI,IAAI,MAAM;CAGf;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,GAAG,SAAS,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAEzF;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CA4B5E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,YAAY,CAapG;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,6BAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CAgDf;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,6BAA6B,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAUzC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/extensions/internal.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,6BAA6B,EAC7B,gBAAgB,EAChB,cAAc,EACd,aAAa,EAEb,YAAY,EACb,MAAM,UAAU,CAAA;AAKjB;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkC;IACzD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;gBAErB,OAAO,SAAO;IAI1B,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAWhD,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI;IAapD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/B,IAAI,IAAI,MAAM;CAGf;AAID,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,gBAAgB,GAAG,SAAS,CAEzF;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAEzF;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,YAAY,GAAG,OAAO,CA4B5E;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,YAAY,GAAG,SAAS,EAAE,IAAI,EAAE,YAAY,GAAG,YAAY,CAapG;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,gBAAgB,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,6BAA6B,GACpC,OAAO,CAAC,IAAI,CAAC,CAkDf;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,cAAc,EACvB,KAAK,CAAC,EAAE,6BAA6B,GACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAUzC"}

package/dist/extensions/internal.js

@@ -33,7 +33,6 @@ __webpack_require__.d(__webpack_exports__, {
     setServerTrackingData: ()=>setServerTrackingData
 });
 const external_event_types_js_namespaceObject = require("./event-types.js");
-const external_logger_js_namespaceObject = require("./logger.js");
 const external_capture_js_namespaceObject = require("./capture.js");
 const external_client_identity_js_namespaceObject = require("./client-identity.js");
 class IdentityCache {
@@ -119,12 +118,12 @@ async function handleIdentify(server, data, sessionId, request, extra) {
             const shouldPublish = changed || firstSeen && !announcedAtInitialize;
             data.identifiedSessions.set(sessionId, mergedIdentity);
             if (shouldPublish) {
-                (0, external_logger_js_namespaceObject.log)(`Identified session ${sessionId} with identity: ${JSON.stringify(mergedIdentity)}`);
-                (0, external_capture_js_namespaceObject.captureEvent)(server, identifyEvent);
+                data.logger(`Identified session ${sessionId}`);
+                (0, external_capture_js_namespaceObject.captureEvent)(server, identifyEvent, data.logger);
             }
-        } else (0, external_logger_js_namespaceObject.log)(`Warning: Supplied identify function returned null for session ${sessionId}`);
+        } else data.logger(`Warning: Supplied identify function returned null for session ${sessionId}`);
     } catch (error) {
-        (0, external_logger_js_namespaceObject.log)(`Error: User supplied identify function threw an error while identifying session ${sessionId} - ${error}`);
+        data.logger(`Error: User supplied identify function threw an error while identifying session ${sessionId} - ${error}`);
     }
 }
 async function resolveEventProperties(data, request, extra) {
@@ -132,7 +131,7 @@ async function resolveEventProperties(data, request, extra) {
     try {
         return await data.options.eventProperties(request, extra) ?? null;
     } catch (e) {
-        (0, external_logger_js_namespaceObject.log)(`eventProperties callback error: ${e}`);
+        data.logger(`eventProperties callback error: ${e}`);
         return null;
     }
 }

package/dist/extensions/internal.mjs

@@ -1,5 +1,4 @@
 import { MCPAnalyticsEventType } from "./event-types.mjs";
-import { log } from "./logger.mjs";
 import { captureEvent } from "./capture.mjs";
 import { stampMetaClientInfo } from "./client-identity.mjs";
 class IdentityCache {
@@ -85,12 +84,12 @@ async function handleIdentify(server, data, sessionId, request, extra) {
             const shouldPublish = changed || firstSeen && !announcedAtInitialize;
             data.identifiedSessions.set(sessionId, mergedIdentity);
             if (shouldPublish) {
-                log(`Identified session ${sessionId} with identity: ${JSON.stringify(mergedIdentity)}`);
-                captureEvent(server, identifyEvent);
+                data.logger(`Identified session ${sessionId}`);
+                captureEvent(server, identifyEvent, data.logger);
             }
-        } else log(`Warning: Supplied identify function returned null for session ${sessionId}`);
+        } else data.logger(`Warning: Supplied identify function returned null for session ${sessionId}`);
     } catch (error) {
-        log(`Error: User supplied identify function threw an error while identifying session ${sessionId} - ${error}`);
+        data.logger(`Error: User supplied identify function threw an error while identifying session ${sessionId} - ${error}`);
     }
 }
 async function resolveEventProperties(data, request, extra) {
@@ -98,7 +97,7 @@ async function resolveEventProperties(data, request, extra) {
     try {
         return await data.options.eventProperties(request, extra) ?? null;
     } catch (e) {
-        log(`eventProperties callback error: ${e}`);
+        data.logger(`eventProperties callback error: ${e}`);
         return null;
     }
 }

package/dist/extensions/logger.d.ts

@@ -3,12 +3,20 @@
  *
  * MCP servers running over the STDIO transport use stdout/stderr to exchange
  * protocol messages, so we cannot use the default `console.log`. We accept a
- * `logger` option on the public API; when omitted, log calls are silently
- * dropped. Errors that affect tracking should still be observable in apps that
- * want them, so the consumer can plug in any function (e.g. `console.error`
- * for non-STDIO transports, a file logger, etc.).
+ * `logger` option on the public API or the legacy logger configured through
+ * `setLogger`; when neither is configured, log calls are silently dropped.
+ * Errors that affect tracking should still be observable in apps that want
+ * them, so the consumer can plug in any function (e.g. `console.error` for
+ * non-STDIO transports, a file logger, etc.).
  */
 export type LoggerFn = (message: string) => void;
 export declare function setLogger(logger: LoggerFn | undefined): void;
+/**
+ * Creates a safe logger for one instrumented server. A server-specific logger
+ * remains isolated, while an omitted logger preserves the legacy `setLogger`
+ * fallback.
+ */
+export declare function createLogger(logger: LoggerFn | undefined): LoggerFn;
+/** Logs through the legacy module-level logger configured by {@link setLogger}. */
 export declare function log(message: string): void;
 //# sourceMappingURL=logger.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/extensions/logger.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAIhD,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAE5D;AAED,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAQzC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/extensions/logger.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;AAIhD,wBAAgB,SAAS,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI,CAE5D;AAYD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAEnE;AAED,mFAAmF;AACnF,wBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEzC"}

package/dist/extensions/logger.js

@@ -24,6 +24,7 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    createLogger: ()=>createLogger,
     log: ()=>log,
     setLogger: ()=>setLogger
 });
@@ -31,14 +32,22 @@ let activeLogger;
 function setLogger(logger) {
     activeLogger = logger;
 }
-function log(message) {
-    if (activeLogger) try {
-        activeLogger(message);
+function writeLog(logger, message) {
+    if (logger) try {
+        logger(message);
     } catch  {}
 }
+function createLogger(logger) {
+    return logger ? (message)=>writeLog(logger, message) : log;
+}
+function log(message) {
+    writeLog(activeLogger, message);
+}
+exports.createLogger = __webpack_exports__.createLogger;
 exports.log = __webpack_exports__.log;
 exports.setLogger = __webpack_exports__.setLogger;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "createLogger",
     "log",
     "setLogger"
 ].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];

package/dist/extensions/logger.mjs

@@ -2,9 +2,15 @@ let activeLogger;
 function setLogger(logger) {
     activeLogger = logger;
 }
-function log(message) {
-    if (activeLogger) try {
-        activeLogger(message);
+function writeLog(logger, message) {
+    if (logger) try {
+        logger(message);
     } catch  {}
 }
-export { log, setLogger };
+function createLogger(logger) {
+    return logger ? (message)=>writeLog(logger, message) : log;
+}
+function log(message) {
+    writeLog(activeLogger, message);
+}
+export { createLogger, log, setLogger };

package/dist/extensions/sink.d.ts

@@ -1,5 +1,6 @@
 import type { PostHog } from 'posthog-node';
 import type { BeforeSendFn, Event, McpEvent } from '../types';
+import { type LoggerFn } from './logger';
 import { type PostHogCaptureEvent } from './posthog-events';
 /** Per-event toggles consulted by the sink when fanning out an event. */
 export interface McpCaptureOptions {
@@ -18,7 +19,7 @@ export interface McpCaptureOptions {
  * and the test harness call it, so tests assert on exactly the payloads that
  * reach `posthog.capture()`.
  */
-export declare function processMcpEvent(event: McpEvent, options: McpCaptureOptions): Promise<{
+export declare function processMcpEvent(event: McpEvent, options: McpCaptureOptions, logger?: LoggerFn): Promise<{
     event: Event;
     captures: PostHogCaptureEvent[];
 } | null>;
@@ -33,7 +34,8 @@ export declare function processMcpEvent(event: McpEvent, options: McpCaptureOpti
  */
 export declare class McpEventSink {
     private readonly posthog;
-    constructor(posthog: PostHog);
+    private readonly logger;
+    constructor(posthog: PostHog, logger?: LoggerFn);
     /**
      * Push an MCP event through the pipeline (sanitize → truncate → fan out →
      * beforeSend → capture). Errors at any stage are logged and the event is

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

@@ -1 +1 @@
-{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../src/extensions/sink.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7D,OAAO,EAAE,KAAK,mBAAmB,EAA6B,MAAM,kBAAkB,CAAA;AAKtF,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,0BAA0B,EAAE,OAAO,CAAA;IACnC,kFAAkF;IAClF,UAAU,CAAC,EAAE,YAAY,CAAA;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CA2BnE;AA4BD;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAE7C;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAmC1E"}
+{"version":3,"file":"sink.d.ts","sourceRoot":"","sources":["../../src/extensions/sink.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAG3C,OAAO,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC7D,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAC7C,OAAO,EAAE,KAAK,mBAAmB,EAA6B,MAAM,kBAAkB,CAAA;AAKtF,yEAAyE;AACzE,MAAM,WAAW,iBAAiB;IAChC,0BAA0B,EAAE,OAAO,CAAA;IACnC,kFAAkF;IAClF,UAAU,CAAC,EAAE,YAAY,CAAA;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,iBAAiB,EAC1B,MAAM,GAAE,QAAc,GACrB,OAAO,CAAC;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,mBAAmB,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CA2BnE;AA6BD;;;;;;;;GAQG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,OAAO,EAAE,OAAO,EAChB,MAAM,GAAE,QAAc;IAGzC;;;;OAIG;IACG,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAmC1E"}

package/dist/extensions/sink.js

@@ -33,18 +33,18 @@ const external_posthog_events_js_namespaceObject = require("./posthog-events.js"
 const external_ids_js_namespaceObject = require("./ids.js");
 const external_sanitization_js_namespaceObject = require("./sanitization.js");
 const external_truncation_js_namespaceObject = require("./truncation.js");
-async function processMcpEvent(event, options) {
+async function processMcpEvent(event, options, logger = external_logger_js_namespaceObject.log) {
     let processed = event;
     try {
         processed = (0, external_sanitization_js_namespaceObject.sanitizeEvent)(processed);
     } catch (err) {
-        (0, external_logger_js_namespaceObject.log)(`Failed to sanitize event: ${err}`);
+        logger(`Failed to sanitize event: ${err}`);
         return null;
     }
     try {
         processed = (0, external_truncation_js_namespaceObject.truncateEvent)(processed);
     } catch (err) {
-        (0, external_logger_js_namespaceObject.log)(`Failed to truncate event: ${err}`);
+        logger(`Failed to truncate event: ${err}`);
         return null;
     }
     processed.id = processed.id || (0, external_ids_js_namespaceObject.newPrefixedId)('evt');
@@ -52,29 +52,30 @@ async function processMcpEvent(event, options) {
     const built = (0, external_posthog_events_js_namespaceObject.buildPostHogCaptureEvents)(fullEvent, {
         enableExceptionAutocapture: options.enableExceptionAutocapture
     });
-    const captures = await applyBeforeSend(built, options.beforeSend);
+    const captures = await applyBeforeSend(built, options.beforeSend, logger);
     return {
         event: fullEvent,
         captures
     };
 }
-async function applyBeforeSend(captures, beforeSend) {
+async function applyBeforeSend(captures, beforeSend, logger) {
     if (!beforeSend) return captures;
     const kept = [];
     for (const capture of captures)try {
         const result = await beforeSend(capture);
         if (result) kept.push(result);
     } catch (err) {
-        (0, external_logger_js_namespaceObject.log)(`beforeSend threw for event ${capture.event}; dropping it: ${err}`);
+        logger(`beforeSend threw for event ${capture.event}; dropping it: ${err}`);
     }
     return kept;
 }
 class McpEventSink {
-    constructor(posthog){
+    constructor(posthog, logger = external_logger_js_namespaceObject.log){
         this.posthog = posthog;
+        this.logger = logger;
     }
     async capture(event, options) {
-        const result = await processMcpEvent(event, options);
+        const result = await processMcpEvent(event, options, this.logger);
         if (!result) return;
         const { event: fullEvent, captures } = result;
         try {
@@ -91,9 +92,9 @@ class McpEventSink {
                     uuid: (0, core_namespaceObject.uuidv7)()
                 });
             }
-            (0, external_logger_js_namespaceObject.log)(`Captured PostHog event ${fullEvent.id} | ${fullEvent.eventType} | ${fullEvent.duration} ms | ${fullEvent.identifyActorGivenId || 'anonymous'}`);
+            this.logger(`Captured PostHog event ${fullEvent.id} | ${fullEvent.eventType} | ${fullEvent.duration} ms | ${fullEvent.identifyActorGivenId ? 'identified' : 'anonymous'}`);
         } catch (err) {
-            (0, external_logger_js_namespaceObject.log)(`Failed to capture PostHog event ${fullEvent.id}: ${err}`);
+            this.logger(`Failed to capture PostHog event ${fullEvent.id}: ${err}`);
         }
     }
 }

package/dist/extensions/sink.mjs

@@ -4,18 +4,18 @@ import { buildPostHogCaptureEvents } from "./posthog-events.mjs";
 import { newPrefixedId } from "./ids.mjs";
 import { sanitizeEvent } from "./sanitization.mjs";
 import { truncateEvent } from "./truncation.mjs";
-async function processMcpEvent(event, options) {
+async function processMcpEvent(event, options, logger = log) {
     let processed = event;
     try {
         processed = sanitizeEvent(processed);
     } catch (err) {
-        log(`Failed to sanitize event: ${err}`);
+        logger(`Failed to sanitize event: ${err}`);
         return null;
     }
     try {
         processed = truncateEvent(processed);
     } catch (err) {
-        log(`Failed to truncate event: ${err}`);
+        logger(`Failed to truncate event: ${err}`);
         return null;
     }
     processed.id = processed.id || newPrefixedId('evt');
@@ -23,29 +23,30 @@ async function processMcpEvent(event, options) {
     const built = buildPostHogCaptureEvents(fullEvent, {
         enableExceptionAutocapture: options.enableExceptionAutocapture
     });
-    const captures = await applyBeforeSend(built, options.beforeSend);
+    const captures = await applyBeforeSend(built, options.beforeSend, logger);
     return {
         event: fullEvent,
         captures
     };
 }
-async function applyBeforeSend(captures, beforeSend) {
+async function applyBeforeSend(captures, beforeSend, logger) {
     if (!beforeSend) return captures;
     const kept = [];
     for (const capture of captures)try {
         const result = await beforeSend(capture);
         if (result) kept.push(result);
     } catch (err) {
-        log(`beforeSend threw for event ${capture.event}; dropping it: ${err}`);
+        logger(`beforeSend threw for event ${capture.event}; dropping it: ${err}`);
     }
     return kept;
 }
 class McpEventSink {
-    constructor(posthog){
+    constructor(posthog, logger = log){
         this.posthog = posthog;
+        this.logger = logger;
     }
     async capture(event, options) {
-        const result = await processMcpEvent(event, options);
+        const result = await processMcpEvent(event, options, this.logger);
         if (!result) return;
         const { event: fullEvent, captures } = result;
         try {
@@ -62,9 +63,9 @@ class McpEventSink {
                     uuid: uuidv7()
                 });
             }
-            log(`Captured PostHog event ${fullEvent.id} | ${fullEvent.eventType} | ${fullEvent.duration} ms | ${fullEvent.identifyActorGivenId || 'anonymous'}`);
+            this.logger(`Captured PostHog event ${fullEvent.id} | ${fullEvent.eventType} | ${fullEvent.duration} ms | ${fullEvent.identifyActorGivenId ? 'identified' : 'anonymous'}`);
         } catch (err) {
-            log(`Failed to capture PostHog event ${fullEvent.id}: ${err}`);
+            this.logger(`Failed to capture PostHog event ${fullEvent.id}: ${err}`);
         }
     }
 }

package/dist/extensions/tools.d.ts

@@ -1,4 +1,5 @@
 import { type CallToolResult, type ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
+import { type LoggerFn } from './logger';
 export declare const GET_MORE_TOOLS_NAME: "get_more_tools";
 /**
  * The configured name of the `get_more_tools` virtual tool, falling back to the
@@ -19,6 +20,6 @@ export declare function getReportMissingToolDescriptor(name?: string): ReportMis
 export declare function getMoreToolsResult(): CallToolResult;
 export declare function handleReportMissing(args: {
     context: string;
-}): CallToolResult;
+}, logger?: LoggerFn): CallToolResult;
 export {};
 //# sourceMappingURL=tools.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/extensions/tools.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAG9F,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAA;AAE5D;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,CAAC,EAAE;IAAE,yBAAyB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzG;AAED,KAAK,2BAA2B,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,wBAAgB,8BAA8B,CAAC,IAAI,GAAE,MAA4B,GAAG,2BAA2B,CA6B9G;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CASnD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,cAAc,CAG7E"}
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/extensions/tools.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAC9F,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7C,eAAO,MAAM,mBAAmB,EAAG,gBAAyB,CAAA;AAE5D;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,CAAC,EAAE;IAAE,yBAAyB,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEzG;AAED,KAAK,2BAA2B,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,wBAAgB,8BAA8B,CAAC,IAAI,GAAE,MAA4B,GAAG,2BAA2B,CA6B9G;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,cAAc,CASnD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,GAAE,QAAc,GAAG,cAAc,CAGrG"}

package/dist/extensions/tools.js

@@ -70,8 +70,8 @@ function getMoreToolsResult() {
         ]
     };
 }
-function handleReportMissing(args) {
-    (0, external_logger_js_namespaceObject.log)(`Missing tool reported: ${JSON.stringify(args)}`);
+function handleReportMissing(args, logger = external_logger_js_namespaceObject.log) {
+    logger(`Missing tool reported: ${JSON.stringify(args)}`);
     return getMoreToolsResult();
 }
 exports.GET_MORE_TOOLS_NAME = __webpack_exports__.GET_MORE_TOOLS_NAME;

package/dist/extensions/tools.mjs

@@ -38,8 +38,8 @@ function getMoreToolsResult() {
         ]
     };
 }
-function handleReportMissing(args) {
-    log(`Missing tool reported: ${JSON.stringify(args)}`);
+function handleReportMissing(args, logger = log) {
+    logger(`Missing tool reported: ${JSON.stringify(args)}`);
     return getMoreToolsResult();
 }
 export { GET_MORE_TOOLS_NAME, getMoreToolsResult, getReportMissingToolDescriptor, handleReportMissing, resolveMissingCapabilityToolName };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAQ3C,OAAO,EAAE,6BAA6B,EAAkB,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGlG,OAAO,KAAK,EAGV,YAAY,EAEZ,mBAAmB,EAGpB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAkCtG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAKjH;AAoFD,OAAO,EAAE,6BAA6B,EAAE,YAAY,EAAE,CAAA;AAItD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAI/C,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,GACb,MAAM,SAAS,CAAA;AAChB,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAQ3C,OAAO,EAAE,6BAA6B,EAAkB,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGlG,OAAO,KAAK,EAGV,YAAY,EAEZ,mBAAmB,EAGpB,MAAM,SAAS,CAAA;AAEhB;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,iBAAS,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB,GAAG,YAAY,CAiCtG;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,iBAAiB,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAKjH;AAuFD,OAAO,EAAE,6BAA6B,EAAE,YAAY,EAAE,CAAA;AAItD,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,KAAK,mBAAmB,GACzB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,EACxB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAI/C,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,EACrB,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACpB,YAAY,GACb,MAAM,SAAS,CAAA;AAChB,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAA;AAC9D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAA"}