@posthog/mcp 0.0.9 → 0.1.17

package/dist/extensions/capture.d.ts

@@ -0,0 +1,13 @@
+import type { MCPServerLike, McpEvent } from '../types';
+/**
+ * Materializes an `McpEvent` against the server's tracking data + session info,
+ * then hands it to the `McpEventSink` (wrapping the user's posthog-node client) for the
+ * sanitize/truncate/beforeSend pipeline and capture. No-ops if the server isn't tracked or
+ * no PostHog client is attached — not passing `posthog` is how you turn capture off.
+ *
+ * Returns the sink's capture promise so the user-facing `capture()` can await it.
+ * Auto-capture callers (tool calls, listings, identify) intentionally ignore the
+ * return value, keeping the tool path isolated from analytics latency/errors.
+ */
+export declare function captureEvent(server: MCPServerLike, eventInput: McpEvent): Promise<void> | undefined;
+//# sourceMappingURL=capture.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/extensions/capture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAMvD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAmDnG"}

package/dist/extensions/capture.js

@@ -0,0 +1,80 @@
+"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__, {
+    captureEvent: ()=>captureEvent
+});
+const external_event_types_js_namespaceObject = require("./event-types.js");
+const external_internal_js_namespaceObject = require("./internal.js");
+const external_logger_js_namespaceObject = require("./logger.js");
+const external_session_js_namespaceObject = require("./session.js");
+function captureEvent(server, eventInput) {
+    const data = (0, external_internal_js_namespaceObject.getServerTrackingData)(server);
+    if (!data) return void (0, external_logger_js_namespaceObject.log)('Warning: Server tracking data not found. Event will not be published.');
+    const sink = data.sink;
+    if (!sink) return;
+    const sessionInfo = (0, external_session_js_namespaceObject.getSessionInfo)(server, data, eventInput.sessionId);
+    const duration = eventInput.duration || (eventInput.timestamp ? Date.now() - eventInput.timestamp.getTime() : void 0);
+    const fullEvent = {
+        id: eventInput.id || '',
+        sessionId: eventInput.sessionId || data.sessionId,
+        eventType: eventInput.eventType || external_event_types_js_namespaceObject.MCPAnalyticsEventType.custom,
+        eventName: eventInput.eventName,
+        timestamp: eventInput.timestamp || new Date(),
+        duration,
+        ipAddress: sessionInfo.ipAddress,
+        sdkLanguage: sessionInfo.sdkLanguage,
+        sdkVersion: sessionInfo.sdkVersion,
+        serverName: sessionInfo.serverName,
+        serverVersion: sessionInfo.serverVersion,
+        clientName: sessionInfo.clientName,
+        clientVersion: sessionInfo.clientVersion,
+        identifyActorGivenId: sessionInfo.identifyActorGivenId,
+        identifyActorData: sessionInfo.identifyActorData,
+        groups: sessionInfo.identifyActorGroups,
+        resourceName: eventInput.resourceName,
+        toolDescription: eventInput.toolDescription,
+        listedToolNames: eventInput.listedToolNames,
+        parameters: eventInput.parameters,
+        response: eventInput.response,
+        userIntent: eventInput.userIntent,
+        userIntentSource: eventInput.userIntentSource,
+        isError: eventInput.isError,
+        error: eventInput.error,
+        conversationId: eventInput.conversationId,
+        properties: eventInput.properties
+    };
+    return sink.capture(fullEvent, {
+        enableExceptionAutocapture: data.options.enableExceptionAutocapture ?? true,
+        beforeSend: data.options.beforeSend
+    });
+}
+exports.captureEvent = __webpack_exports__.captureEvent;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "captureEvent"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/extensions/capture.mjs

@@ -0,0 +1,46 @@
+import { MCPAnalyticsEventType } from "./event-types.mjs";
+import { getServerTrackingData } from "./internal.mjs";
+import { log } from "./logger.mjs";
+import { getSessionInfo } from "./session.mjs";
+function captureEvent(server, eventInput) {
+    const data = getServerTrackingData(server);
+    if (!data) return void log('Warning: Server tracking data not found. Event will not be published.');
+    const sink = data.sink;
+    if (!sink) return;
+    const sessionInfo = getSessionInfo(server, data, eventInput.sessionId);
+    const duration = eventInput.duration || (eventInput.timestamp ? Date.now() - eventInput.timestamp.getTime() : void 0);
+    const fullEvent = {
+        id: eventInput.id || '',
+        sessionId: eventInput.sessionId || data.sessionId,
+        eventType: eventInput.eventType || MCPAnalyticsEventType.custom,
+        eventName: eventInput.eventName,
+        timestamp: eventInput.timestamp || new Date(),
+        duration,
+        ipAddress: sessionInfo.ipAddress,
+        sdkLanguage: sessionInfo.sdkLanguage,
+        sdkVersion: sessionInfo.sdkVersion,
+        serverName: sessionInfo.serverName,
+        serverVersion: sessionInfo.serverVersion,
+        clientName: sessionInfo.clientName,
+        clientVersion: sessionInfo.clientVersion,
+        identifyActorGivenId: sessionInfo.identifyActorGivenId,
+        identifyActorData: sessionInfo.identifyActorData,
+        groups: sessionInfo.identifyActorGroups,
+        resourceName: eventInput.resourceName,
+        toolDescription: eventInput.toolDescription,
+        listedToolNames: eventInput.listedToolNames,
+        parameters: eventInput.parameters,
+        response: eventInput.response,
+        userIntent: eventInput.userIntent,
+        userIntentSource: eventInput.userIntentSource,
+        isError: eventInput.isError,
+        error: eventInput.error,
+        conversationId: eventInput.conversationId,
+        properties: eventInput.properties
+    };
+    return sink.capture(fullEvent, {
+        enableExceptionAutocapture: data.options.enableExceptionAutocapture ?? true,
+        beforeSend: data.options.beforeSend
+    });
+}
+export { captureEvent };

package/dist/extensions/compatibility.d.ts

@@ -0,0 +1,23 @@
+import type { HighLevelMCPServerLike, MCPServerLike } from '../types';
+type ServerRecord = Record<string, unknown>;
+/**
+ * PostHog MCP analytics Compatibility Module
+ *
+ * This module ensures compatibility with Model Context Protocol TypeScript SDK.
+ * PostHog MCP analytics only supports MCP SDK version 1.11 and above.
+ *
+ * Version 1.11+ is required because it introduced stable APIs for:
+ * - Tool registration and handling
+ * - Request handler access patterns
+ * - Client version detection
+ * - Server info structure
+ */
+export declare function logCompatibilityWarning(): void;
+export declare function isHighLevelServer(server: unknown): server is ServerRecord & {
+    server: ServerRecord;
+};
+export declare function isLowLevelServer(server: unknown): server is ServerRecord;
+export declare function isCompatibleServerType(server: unknown): MCPServerLike | HighLevelMCPServerLike;
+export declare function getMCPCompatibleErrorMessage(error: unknown): string;
+export {};
+//# sourceMappingURL=compatibility.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../src/extensions/compatibility.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAGrE,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAE3C;;;;;;;;;;;GAWG;AAGH,wBAAgB,uBAAuB,IAAI,IAAI,CAI9C;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,GAAG,aAAa,GAAG,sBAAsB,CAgC9F;AAsDD,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAanE"}

package/dist/extensions/compatibility.js

@@ -0,0 +1,113 @@
+"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__, {
+    isLowLevelServer: ()=>isLowLevelServer,
+    isHighLevelServer: ()=>isHighLevelServer,
+    logCompatibilityWarning: ()=>logCompatibilityWarning,
+    isCompatibleServerType: ()=>isCompatibleServerType,
+    getMCPCompatibleErrorMessage: ()=>getMCPCompatibleErrorMessage
+});
+const external_logger_js_namespaceObject = require("./logger.js");
+function logCompatibilityWarning() {
+    (0, external_logger_js_namespaceObject.log)('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;
+}
+function isLowLevelServer(server) {
+    return !!server && 'object' == typeof server && !('server' in server);
+}
+function isCompatibleServerType(server) {
+    if (!server || 'object' != typeof server) {
+        logCompatibilityWarning();
+        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) {
+            logCompatibilityWarning();
+            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) {
+            logCompatibilityWarning();
+            throw new Error('PostHog MCP analytics SDK compatibility error: High-level server must have tool() method. This requires MCP SDK v1.11 or higher.');
+        }
+        const targetServer = server.server;
+        validateLowLevelServer(targetServer);
+        return server;
+    }
+    validateLowLevelServer(server);
+    return server;
+}
+function validateLowLevelServer(server) {
+    if (!server || 'object' != typeof server) {
+        logCompatibilityWarning();
+        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) {
+        logCompatibilityWarning();
+        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)) {
+        logCompatibilityWarning();
+        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();
+        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) {
+        logCompatibilityWarning();
+        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)) {
+        logCompatibilityWarning();
+        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.');
+    }
+}
+function getMCPCompatibleErrorMessage(error) {
+    if (error instanceof Error) try {
+        return JSON.stringify(error, Object.getOwnPropertyNames(error));
+    } catch  {}
+    else if ('string' == typeof error) return error;
+    else if ('object' == typeof error && null !== error) return JSON.stringify(error);
+    return 'Unknown error';
+}
+exports.getMCPCompatibleErrorMessage = __webpack_exports__.getMCPCompatibleErrorMessage;
+exports.isCompatibleServerType = __webpack_exports__.isCompatibleServerType;
+exports.isHighLevelServer = __webpack_exports__.isHighLevelServer;
+exports.isLowLevelServer = __webpack_exports__.isLowLevelServer;
+exports.logCompatibilityWarning = __webpack_exports__.logCompatibilityWarning;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "getMCPCompatibleErrorMessage",
+    "isCompatibleServerType",
+    "isHighLevelServer",
+    "isLowLevelServer",
+    "logCompatibilityWarning"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/extensions/compatibility.mjs

@@ -0,0 +1,67 @@
+import { log } from "./logger.mjs";
+function logCompatibilityWarning() {
+    log('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;
+}
+function isLowLevelServer(server) {
+    return !!server && 'object' == typeof server && !('server' in server);
+}
+function isCompatibleServerType(server) {
+    if (!server || 'object' != typeof server) {
+        logCompatibilityWarning();
+        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) {
+            logCompatibilityWarning();
+            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) {
+            logCompatibilityWarning();
+            throw new Error('PostHog MCP analytics SDK compatibility error: High-level server must have tool() method. This requires MCP SDK v1.11 or higher.');
+        }
+        const targetServer = server.server;
+        validateLowLevelServer(targetServer);
+        return server;
+    }
+    validateLowLevelServer(server);
+    return server;
+}
+function validateLowLevelServer(server) {
+    if (!server || 'object' != typeof server) {
+        logCompatibilityWarning();
+        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) {
+        logCompatibilityWarning();
+        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)) {
+        logCompatibilityWarning();
+        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();
+        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) {
+        logCompatibilityWarning();
+        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)) {
+        logCompatibilityWarning();
+        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.');
+    }
+}
+function getMCPCompatibleErrorMessage(error) {
+    if (error instanceof Error) try {
+        return JSON.stringify(error, Object.getOwnPropertyNames(error));
+    } catch  {}
+    else if ('string' == typeof error) return error;
+    else if ('object' == typeof error && null !== error) return JSON.stringify(error);
+    return 'Unknown error';
+}
+export { getMCPCompatibleErrorMessage, isCompatibleServerType, isHighLevelServer, isLowLevelServer, logCompatibilityWarning };

package/dist/extensions/constants.d.ts

@@ -0,0 +1,39 @@
+export declare const INACTIVITY_TIMEOUT_IN_MINUTES = 30;
+export declare const DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\"";
+export declare const DEFAULT_CONVERSATION_ID_DESCRIPTION = "Echo the conversation_id from the server's previous response. The server provides it on the first call \u2014 never invent one, and do not issue parallel tool calls until you have it.";
+export declare const POSTHOG_MCP_ANALYTICS_SOURCE = "posthog_mcp_analytics";
+export declare const PostHogMCPAnalyticsEvent: {
+    readonly Custom: "$mcp_custom";
+    readonly Exception: "$exception";
+    readonly Identify: "$identify";
+    readonly Initialize: "$mcp_initialize";
+    readonly MissingCapability: "$mcp_missing_capability";
+    readonly PromptGet: "$mcp_prompt_get";
+    readonly PromptsList: "$mcp_prompts_list";
+    readonly ResourceRead: "$mcp_resource_read";
+    readonly ResourcesList: "$mcp_resources_list";
+    readonly ToolCall: "$mcp_tool_call";
+    readonly ToolsList: "$mcp_tools_list";
+};
+export type PostHogMCPAnalyticsEvent = (typeof PostHogMCPAnalyticsEvent)[keyof typeof PostHogMCPAnalyticsEvent];
+export declare const PostHogMCPAnalyticsProperty: {
+    readonly ClientName: "$mcp_client_name";
+    readonly ClientVersion: "$mcp_client_version";
+    readonly ConversationId: "$mcp_conversation_id";
+    readonly DurationMs: "$mcp_duration_ms";
+    readonly IsError: "$mcp_is_error";
+    readonly Intent: "$mcp_intent";
+    readonly IntentSource: "$mcp_intent_source";
+    readonly ListedToolNames: "$mcp_listed_tool_names";
+    readonly Parameters: "$mcp_parameters";
+    readonly ResourceName: "$mcp_resource_name";
+    readonly Response: "$mcp_response";
+    readonly ServerName: "$mcp_server_name";
+    readonly ServerVersion: "$mcp_server_version";
+    readonly SessionId: "$session_id";
+    readonly Source: "$mcp_source";
+    readonly ToolDescription: "$mcp_tool_description";
+    readonly ToolName: "$mcp_tool_name";
+};
+export type PostHogMCPAnalyticsProperty = (typeof PostHogMCPAnalyticsProperty)[keyof typeof PostHogMCPAnalyticsProperty];
+//# sourceMappingURL=constants.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/extensions/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,6BAA6B,KAAK,CAAA;AAE/C,eAAO,MAAM,qCAAqC,2hBAAyhB,CAAA;AAE3kB,eAAO,MAAM,mCAAmC,4LACsI,CAAA;AAEtL,eAAO,MAAM,4BAA4B,0BAA0B,CAAA;AAInE,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;;;;;;;;;;;;;;;;;;CAkB9B,CAAA;AAEV,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAA"}

package/dist/extensions/constants.js

@@ -0,0 +1,86 @@
+"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__, {
+    DEFAULT_CONTEXT_PARAMETER_DESCRIPTION: ()=>DEFAULT_CONTEXT_PARAMETER_DESCRIPTION,
+    DEFAULT_CONVERSATION_ID_DESCRIPTION: ()=>DEFAULT_CONVERSATION_ID_DESCRIPTION,
+    INACTIVITY_TIMEOUT_IN_MINUTES: ()=>INACTIVITY_TIMEOUT_IN_MINUTES,
+    POSTHOG_MCP_ANALYTICS_SOURCE: ()=>POSTHOG_MCP_ANALYTICS_SOURCE,
+    PostHogMCPAnalyticsEvent: ()=>PostHogMCPAnalyticsEvent,
+    PostHogMCPAnalyticsProperty: ()=>PostHogMCPAnalyticsProperty
+});
+const INACTIVITY_TIMEOUT_IN_MINUTES = 30;
+const DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\"";
+const DEFAULT_CONVERSATION_ID_DESCRIPTION = "Echo the conversation_id from the server's previous response. The server provides it on the first call \u2014 never invent one, and do not issue parallel tool calls until you have it.";
+const POSTHOG_MCP_ANALYTICS_SOURCE = 'posthog_mcp_analytics';
+const PostHogMCPAnalyticsEvent = {
+    Custom: '$mcp_custom',
+    Exception: '$exception',
+    Identify: '$identify',
+    Initialize: '$mcp_initialize',
+    MissingCapability: '$mcp_missing_capability',
+    PromptGet: '$mcp_prompt_get',
+    PromptsList: '$mcp_prompts_list',
+    ResourceRead: '$mcp_resource_read',
+    ResourcesList: '$mcp_resources_list',
+    ToolCall: '$mcp_tool_call',
+    ToolsList: '$mcp_tools_list'
+};
+const PostHogMCPAnalyticsProperty = {
+    ClientName: '$mcp_client_name',
+    ClientVersion: '$mcp_client_version',
+    ConversationId: '$mcp_conversation_id',
+    DurationMs: '$mcp_duration_ms',
+    IsError: '$mcp_is_error',
+    Intent: '$mcp_intent',
+    IntentSource: '$mcp_intent_source',
+    ListedToolNames: '$mcp_listed_tool_names',
+    Parameters: '$mcp_parameters',
+    ResourceName: '$mcp_resource_name',
+    Response: '$mcp_response',
+    ServerName: '$mcp_server_name',
+    ServerVersion: '$mcp_server_version',
+    SessionId: '$session_id',
+    Source: '$mcp_source',
+    ToolDescription: "$mcp_tool_description",
+    ToolName: '$mcp_tool_name'
+};
+exports.DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = __webpack_exports__.DEFAULT_CONTEXT_PARAMETER_DESCRIPTION;
+exports.DEFAULT_CONVERSATION_ID_DESCRIPTION = __webpack_exports__.DEFAULT_CONVERSATION_ID_DESCRIPTION;
+exports.INACTIVITY_TIMEOUT_IN_MINUTES = __webpack_exports__.INACTIVITY_TIMEOUT_IN_MINUTES;
+exports.POSTHOG_MCP_ANALYTICS_SOURCE = __webpack_exports__.POSTHOG_MCP_ANALYTICS_SOURCE;
+exports.PostHogMCPAnalyticsEvent = __webpack_exports__.PostHogMCPAnalyticsEvent;
+exports.PostHogMCPAnalyticsProperty = __webpack_exports__.PostHogMCPAnalyticsProperty;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "DEFAULT_CONTEXT_PARAMETER_DESCRIPTION",
+    "DEFAULT_CONVERSATION_ID_DESCRIPTION",
+    "INACTIVITY_TIMEOUT_IN_MINUTES",
+    "POSTHOG_MCP_ANALYTICS_SOURCE",
+    "PostHogMCPAnalyticsEvent",
+    "PostHogMCPAnalyticsProperty"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/extensions/constants.mjs

@@ -0,0 +1,37 @@
+const INACTIVITY_TIMEOUT_IN_MINUTES = 30;
+const DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\"";
+const DEFAULT_CONVERSATION_ID_DESCRIPTION = "Echo the conversation_id from the server's previous response. The server provides it on the first call \u2014 never invent one, and do not issue parallel tool calls until you have it.";
+const POSTHOG_MCP_ANALYTICS_SOURCE = 'posthog_mcp_analytics';
+const PostHogMCPAnalyticsEvent = {
+    Custom: '$mcp_custom',
+    Exception: '$exception',
+    Identify: '$identify',
+    Initialize: '$mcp_initialize',
+    MissingCapability: '$mcp_missing_capability',
+    PromptGet: '$mcp_prompt_get',
+    PromptsList: '$mcp_prompts_list',
+    ResourceRead: '$mcp_resource_read',
+    ResourcesList: '$mcp_resources_list',
+    ToolCall: '$mcp_tool_call',
+    ToolsList: '$mcp_tools_list'
+};
+const PostHogMCPAnalyticsProperty = {
+    ClientName: '$mcp_client_name',
+    ClientVersion: '$mcp_client_version',
+    ConversationId: '$mcp_conversation_id',
+    DurationMs: '$mcp_duration_ms',
+    IsError: '$mcp_is_error',
+    Intent: '$mcp_intent',
+    IntentSource: '$mcp_intent_source',
+    ListedToolNames: '$mcp_listed_tool_names',
+    Parameters: '$mcp_parameters',
+    ResourceName: '$mcp_resource_name',
+    Response: '$mcp_response',
+    ServerName: '$mcp_server_name',
+    ServerVersion: '$mcp_server_version',
+    SessionId: '$session_id',
+    Source: '$mcp_source',
+    ToolDescription: "$mcp_tool_description",
+    ToolName: '$mcp_tool_name'
+};
+export { DEFAULT_CONTEXT_PARAMETER_DESCRIPTION, DEFAULT_CONVERSATION_ID_DESCRIPTION, INACTIVITY_TIMEOUT_IN_MINUTES, POSTHOG_MCP_ANALYTICS_SOURCE, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty };

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

@@ -0,0 +1,31 @@
+import type { MCPAnalyticsOptions } from '../types';
+interface JsonSchema {
+    additionalProperties?: boolean;
+    allOf?: unknown;
+    anyOf?: unknown;
+    oneOf?: unknown;
+    properties?: Record<string, unknown>;
+    required?: string[];
+    type?: string;
+}
+export interface ContextInjectableTool {
+    inputSchema?: JsonSchema;
+    name?: string;
+    [key: string]: unknown;
+}
+export declare function isContextEnabled(context: MCPAnalyticsOptions['context']): boolean;
+export declare function getContextDescription(context: MCPAnalyticsOptions['context']): string | undefined;
+/**
+ * Adds a context parameter to a tool's JSON Schema.
+ * This function is called AFTER the MCP SDK has converted Zod schemas to JSON Schema,
+ * so we only need to handle JSON Schema format.
+ *
+ * Skips injection (with warning) for:
+ * - Tools that already have a 'context' parameter
+ * - Complex schemas (oneOf/allOf/anyOf) that can't safely have properties added
+ * - Schemas with additionalProperties: false
+ */
+export declare function addContextParameterToTool<TTool extends ContextInjectableTool>(tool: TTool, contextDescriptionOverride?: string): TTool;
+export declare function addContextParameterToTools<TTool extends ContextInjectableTool>(tools: TTool[], contextDescriptionOverride?: string): TTool[];
+export {};
+//# sourceMappingURL=context-parameters.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"context-parameters.d.ts","sourceRoot":"","sources":["../../src/extensions/context-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAInD,UAAU,UAAU;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,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,GAClC,KAAK,CAgEP;AAED,wBAAgB,0BAA0B,CAAC,KAAK,SAAS,qBAAqB,EAC5E,KAAK,EAAE,KAAK,EAAE,EACd,0BAA0B,CAAC,EAAE,MAAM,GAClC,KAAK,EAAE,CAQT"}

package/dist/extensions/context-parameters.js

@@ -0,0 +1,93 @@
+"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__, {
+    addContextParameterToTools: ()=>addContextParameterToTools,
+    addContextParameterToTool: ()=>addContextParameterToTool,
+    getContextDescription: ()=>getContextDescription,
+    isContextEnabled: ()=>isContextEnabled
+});
+const external_constants_js_namespaceObject = require("./constants.js");
+const external_logger_js_namespaceObject = require("./logger.js");
+function isContextEnabled(context) {
+    return false !== context;
+}
+function getContextDescription(context) {
+    return 'object' == typeof context ? context.description : void 0;
+}
+function addContextParameterToTool(tool, contextDescriptionOverride) {
+    const modifiedTool = {
+        ...tool
+    };
+    const toolName = tool.name || 'unknown';
+    const schema = modifiedTool.inputSchema;
+    if (schema?.properties?.context) {
+        (0, external_logger_js_namespaceObject.log)(`WARN: Tool "${toolName}" already has 'context' parameter. Skipping context injection.`);
+        return modifiedTool;
+    }
+    if (schema?.oneOf || schema?.allOf || schema?.anyOf) {
+        (0, external_logger_js_namespaceObject.log)(`WARN: Tool "${toolName}" has complex schema (oneOf/allOf/anyOf). Skipping context injection.`);
+        return modifiedTool;
+    }
+    if (!modifiedTool.inputSchema) modifiedTool.inputSchema = {
+        type: 'object',
+        properties: {},
+        required: []
+    };
+    const contextDescription = contextDescriptionOverride || external_constants_js_namespaceObject.DEFAULT_CONTEXT_PARAMETER_DESCRIPTION;
+    modifiedTool.inputSchema = JSON.parse(JSON.stringify(modifiedTool.inputSchema));
+    const inputSchema = modifiedTool.inputSchema;
+    if (!inputSchema.properties) inputSchema.properties = {};
+    if (false === inputSchema.additionalProperties) inputSchema.additionalProperties = void 0;
+    inputSchema.properties.context = {
+        type: 'string',
+        description: contextDescription
+    };
+    if (Array.isArray(inputSchema.required)) {
+        if (!inputSchema.required.includes('context')) inputSchema.required.push('context');
+    } else inputSchema.required = [
+        'context'
+    ];
+    return modifiedTool;
+}
+function addContextParameterToTools(tools, contextDescriptionOverride) {
+    return tools.map((tool)=>{
+        if ('get_more_tools' === tool.name) return tool;
+        return addContextParameterToTool(tool, contextDescriptionOverride);
+    });
+}
+exports.addContextParameterToTool = __webpack_exports__.addContextParameterToTool;
+exports.addContextParameterToTools = __webpack_exports__.addContextParameterToTools;
+exports.getContextDescription = __webpack_exports__.getContextDescription;
+exports.isContextEnabled = __webpack_exports__.isContextEnabled;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "addContextParameterToTool",
+    "addContextParameterToTools",
+    "getContextDescription",
+    "isContextEnabled"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});