@posthog/mcp 0.11.7 → 0.13.0

package/README.md

@@ -137,9 +137,10 @@ cannot tell that it is yours, its value is recorded as `$mcp_intent`. It never l
 and it is capped at 2048 characters. Two ways out, both one line:
 
 ```ts
-instrument(server, posthog, { context: false })                   // no injection, no capture
+instrument(server, posthog, { context: false }) // no injection, no capture
 
-instrument(server, posthog, {                                     // keep it, drop the property
+instrument(server, posthog, {
+  // keep it, drop the property
   beforeSend: (event) => {
     delete event.properties.$mcp_intent
     return event
@@ -149,6 +150,54 @@ instrument(server, posthog, {                                     // keep it, dr
 
 `intentFallback` is the third option: supply the intent yourself when the agent did not send one.
 
+### What `$mcp_llm_model` records, and when it stays empty
+
+`captureModel` is **off** by default. Turn it on and the SDK adds a required `llm_model` parameter to
+every tool it advertises — including the `get_more_tools` virtual tool — asks the agent which model
+it runs as, and records the answer as `$mcp_llm_model` with `$mcp_llm_model_source = "self_reported"`.
+
+The value is self-reported and unverified, exactly like `clientInfo` in the MCP spec. Use it to spot
+degradation across models ("does our MCP get worse on model X?"), never for billing or access
+control. An agent that answers `unknown` is recorded as nothing rather than as a model called
+"unknown".
+
+Unlike `context`, this option degrades to **silence** rather than to a kept argument. Both the strip
+and the capture require the SDK to have confirmed the parameter is its own:
+
+- `instrument(server)` on a high-level `McpServer` resolves ownership for your registered tools per
+  request from the live tool registry, so those work even on a fresh instance.
+- The `get_more_tools` virtual tool works on any instance and on either server type: the SDK writes
+  that descriptor itself, so what it declares is known without a listing.
+- Instrumenting a low-level `Server` learns ownership of **your** tools while serving `tools/list`.
+  On a server that builds a fresh instance per HTTP request — `createMcpHandler`, or
+  `@rekog/mcp-nest` in its stateless mode — the instance handling a `tools/call` never served one,
+  so for those tools it neither strips `llm_model` nor records `$mcp_llm_model`. Nothing breaks and
+  no wrong value is stored; the property is simply absent while agents still pay a token for the
+  extra field.
+
+As with `context`, what matters is instance lifetime rather than statelessness: a transport-stateless
+server (`sessionIdGenerator: undefined`) that keeps one long-lived server object learns ownership
+from the first `tools/list` and keeps it.
+
+For a custom dispatcher, enable the same option on `PostHogMCP`. Its `prepareToolList()` helper
+injects the field and records ownership by tool name; `prepareToolCall()` returns `llmModel` and
+`llmModelSource` while removing the SDK-owned argument before dispatch. Pass both fields to
+`captureToolCall()`. Pass the original tool descriptor on each call so this also works when
+`tools/list` and `tools/call` reach different server replicas:
+
+```ts
+const posthog = new PostHogMCP(process.env.POSTHOG_PROJECT_TOKEN, { captureModel: true })
+
+const tools = posthog.prepareToolList(serverTools)
+const originalTool = serverTools.find((tool) => tool.name === toolName)
+const { args, llmModel, llmModelSource } = posthog.prepareToolCall(toolName, rawArgs, { originalTool })
+const result = await dispatch(toolName, args)
+
+posthog.captureToolCall({ toolName, llmModel, llmModelSource, isError: false })
+```
+
+A persistent single-process dispatcher can omit `originalTool` after it has prepared its tool list.
+
 ### If you switched to `instrument(server.server)`
 
 Before v2 support landed, the compatibility gate rejected high-level v2 servers, and the usual

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

@@ -1,4 +1,5 @@
 import type { AnalyticsParameterOwnership } from '../types';
+import { type LoggerFn } from './logger';
 export interface AnalyticsInjectableJsonSchema {
     $ref?: unknown;
     additionalProperties?: boolean;
@@ -11,12 +12,31 @@ export interface AnalyticsInjectableJsonSchema {
 }
 export declare function hasAnalyticsParameter(schema: AnalyticsInjectableJsonSchema | undefined, parameterName: string): boolean;
 export declare function canInjectAnalyticsParameter(schema: AnalyticsInjectableJsonSchema | undefined, parameterName: string): boolean;
+export interface AnalyticsInjectableTool {
+    inputSchema?: AnalyticsInjectableJsonSchema;
+    name?: string;
+    [key: string]: unknown;
+}
+/**
+ * Adds a required string parameter to a tool's JSON Schema. Called AFTER the MCP
+ * SDK has converted Zod schemas to JSON Schema, so only JSON Schema needs
+ * handling.
+ *
+ * Shared by every analytics parameter we inject (`context`, `llm_model`) so
+ * schema ownership, cloning, and required-field behavior cannot drift between
+ * them. `injectionLabel` only names the feature in the skip warnings.
+ *
+ * Skips injection (with a warning) for:
+ * - Tools that already declare the parameter — it is theirs, not ours
+ * - Complex schemas (oneOf/allOf/anyOf/$ref) that can't safely gain properties
+ */
+export declare function addAnalyticsParameterToTool<TTool extends AnalyticsInjectableTool>(tool: TTool, parameterName: string, description: string, injectionLabel: string, logger?: LoggerFn): TTool;
 export declare function analyticsOwnsParameter(inputSchema: unknown, parameterName: string): boolean;
 export declare function getAnalyticsParameterOwnership(inputSchema: unknown, outputSchema?: unknown): AnalyticsParameterOwnership;
 /**
  * Removes the arguments we injected, leaving the host's own. Input-side only, so
- * it takes just those two flags rather than the whole ownership record — callers
+ * it takes just those flags rather than the whole ownership record — callers
  * that have no output-schema context should not have to invent a value for it.
  */
-export declare function stripOwnedAnalyticsArguments(args: unknown, ownership: Pick<AnalyticsParameterOwnership, 'context' | 'conversationId'>): unknown;
+export declare function stripOwnedAnalyticsArguments(args: unknown, ownership: Pick<AnalyticsParameterOwnership, 'context' | 'conversationId' | 'llmModel'>): unknown;
 //# sourceMappingURL=analytics-parameters.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"analytics-parameters.d.ts","sourceRoot":"","sources":["../../src/extensions/analytics-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AAiB3D,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,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,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,6BAA6B,GAAG,SAAS,EACjD,aAAa,EAAE,MAAM,GACpB,OAAO,CAET;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,6BAA6B,GAAG,SAAS,EACjD,aAAa,EAAE,MAAM,GACpB,OAAO,CAIT;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAyB3F;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,OAAO,EACpB,YAAY,CAAC,EAAE,OAAO,GACrB,2BAA2B,CAM7B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,IAAI,CAAC,2BAA2B,EAAE,SAAS,GAAG,gBAAgB,CAAC,GACzE,OAAO,CAWT"}
+{"version":3,"file":"analytics-parameters.d.ts","sourceRoot":"","sources":["../../src/extensions/analytics-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA;AAC3D,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAiB7C,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,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,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,6BAA6B,GAAG,SAAS,EACjD,aAAa,EAAE,MAAM,GACpB,OAAO,CAET;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,6BAA6B,GAAG,SAAS,EACjD,aAAa,EAAE,MAAM,GACpB,OAAO,CAIT;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,6BAA6B,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,SAAS,uBAAuB,EAC/E,IAAI,EAAE,KAAK,EACX,aAAa,EAAE,MAAM,EACrB,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,MAAM,GAAE,QAAc,GACrB,KAAK,CAqDP;AAED,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAyB3F;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,OAAO,EACpB,YAAY,CAAC,EAAE,OAAO,GACrB,2BAA2B,CAO7B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,IAAI,CAAC,2BAA2B,EAAE,SAAS,GAAG,gBAAgB,GAAG,UAAU,CAAC,GACtF,OAAO,CAeT"}

package/dist/extensions/analytics-parameters.js

@@ -1,11 +1,15 @@
 "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__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
     };
 })();
 (()=>{
@@ -13,7 +17,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {
@@ -24,12 +28,14 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    hasAnalyticsParameter: ()=>hasAnalyticsParameter,
+    addAnalyticsParameterToTool: ()=>addAnalyticsParameterToTool,
     analyticsOwnsParameter: ()=>analyticsOwnsParameter,
-    getAnalyticsParameterOwnership: ()=>getAnalyticsParameterOwnership,
     canInjectAnalyticsParameter: ()=>canInjectAnalyticsParameter,
+    getAnalyticsParameterOwnership: ()=>getAnalyticsParameterOwnership,
+    hasAnalyticsParameter: ()=>hasAnalyticsParameter,
     stripOwnedAnalyticsArguments: ()=>stripOwnedAnalyticsArguments
 });
+const external_logger_js_namespaceObject = require("./logger.js");
 const external_mcp_sdk_compat_js_namespaceObject = require("./mcp-sdk-compat.js");
 const external_output_instructions_js_namespaceObject = require("./output-instructions.js");
 const JSON_SCHEMA_KEYWORDS = [
@@ -50,6 +56,36 @@ function hasAnalyticsParameter(schema, parameterName) {
 function canInjectAnalyticsParameter(schema, parameterName) {
     return !hasAnalyticsParameter(schema, parameterName) && !schema?.$ref && !schema?.oneOf && !schema?.allOf && !schema?.anyOf;
 }
+function addAnalyticsParameterToTool(tool, parameterName, description, injectionLabel, logger = external_logger_js_namespaceObject.log) {
+    const modifiedTool = {
+        ...tool
+    };
+    const toolName = tool.name || 'unknown';
+    const schema = modifiedTool.inputSchema;
+    if (!canInjectAnalyticsParameter(schema, parameterName)) {
+        logger(hasAnalyticsParameter(schema, parameterName) ? `WARN: Tool "${toolName}" already has '${parameterName}' parameter. Skipping ${injectionLabel} injection.` : `WARN: Tool "${toolName}" has complex schema (oneOf/allOf/anyOf/$ref). Skipping ${injectionLabel} injection.`);
+        return modifiedTool;
+    }
+    if (!modifiedTool.inputSchema) modifiedTool.inputSchema = {
+        type: 'object',
+        properties: {},
+        required: []
+    };
+    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[parameterName] = {
+        type: 'string',
+        description
+    };
+    if (Array.isArray(inputSchema.required)) {
+        if (!inputSchema.required.includes(parameterName)) inputSchema.required.push(parameterName);
+    } else inputSchema.required = [
+        parameterName
+    ];
+    return modifiedTool;
+}
 function analyticsOwnsParameter(inputSchema, parameterName) {
     if (!inputSchema || 'object' != typeof inputSchema) return canInjectAnalyticsParameter(void 0, parameterName);
     if ((0, external_mcp_sdk_compat_js_namespaceObject.isZodRawShapeCompat)(inputSchema)) return canInjectAnalyticsParameter({
@@ -68,6 +104,7 @@ function getAnalyticsParameterOwnership(inputSchema, outputSchema) {
     return {
         context: analyticsOwnsParameter(inputSchema, 'context'),
         conversationId: analyticsOwnsParameter(inputSchema, 'conversation_id'),
+        llmModel: analyticsOwnsParameter(inputSchema, 'llm_model'),
         outputInstructions: (0, external_output_instructions_js_namespaceObject.canDeclareOutputInstructions)(outputSchema)
     };
 }
@@ -81,20 +118,26 @@ function stripOwnedAnalyticsArguments(args, ownership) {
         const { conversation_id: _conversationId, ...rest } = cleanedArgs;
         cleanedArgs = rest;
     }
+    if (ownership.llmModel && cleanedArgs && 'object' == typeof cleanedArgs && 'llm_model' in cleanedArgs) {
+        const { llm_model: _llmModel, ...rest } = cleanedArgs;
+        cleanedArgs = rest;
+    }
     return cleanedArgs;
 }
+exports.addAnalyticsParameterToTool = __webpack_exports__.addAnalyticsParameterToTool;
 exports.analyticsOwnsParameter = __webpack_exports__.analyticsOwnsParameter;
 exports.canInjectAnalyticsParameter = __webpack_exports__.canInjectAnalyticsParameter;
 exports.getAnalyticsParameterOwnership = __webpack_exports__.getAnalyticsParameterOwnership;
 exports.hasAnalyticsParameter = __webpack_exports__.hasAnalyticsParameter;
 exports.stripOwnedAnalyticsArguments = __webpack_exports__.stripOwnedAnalyticsArguments;
-for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "addAnalyticsParameterToTool",
     "analyticsOwnsParameter",
     "canInjectAnalyticsParameter",
     "getAnalyticsParameterOwnership",
     "hasAnalyticsParameter",
     "stripOwnedAnalyticsArguments"
-].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true
 });

package/dist/extensions/analytics-parameters.mjs

@@ -1,3 +1,4 @@
+import { log } from "./logger.mjs";
 import { getObjectShape, isZodRawShapeCompat } from "./mcp-sdk-compat.mjs";
 import { canDeclareOutputInstructions } from "./output-instructions.mjs";
 const JSON_SCHEMA_KEYWORDS = [
@@ -18,6 +19,36 @@ function hasAnalyticsParameter(schema, parameterName) {
 function canInjectAnalyticsParameter(schema, parameterName) {
     return !hasAnalyticsParameter(schema, parameterName) && !schema?.$ref && !schema?.oneOf && !schema?.allOf && !schema?.anyOf;
 }
+function addAnalyticsParameterToTool(tool, parameterName, description, injectionLabel, logger = log) {
+    const modifiedTool = {
+        ...tool
+    };
+    const toolName = tool.name || 'unknown';
+    const schema = modifiedTool.inputSchema;
+    if (!canInjectAnalyticsParameter(schema, parameterName)) {
+        logger(hasAnalyticsParameter(schema, parameterName) ? `WARN: Tool "${toolName}" already has '${parameterName}' parameter. Skipping ${injectionLabel} injection.` : `WARN: Tool "${toolName}" has complex schema (oneOf/allOf/anyOf/$ref). Skipping ${injectionLabel} injection.`);
+        return modifiedTool;
+    }
+    if (!modifiedTool.inputSchema) modifiedTool.inputSchema = {
+        type: 'object',
+        properties: {},
+        required: []
+    };
+    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[parameterName] = {
+        type: 'string',
+        description
+    };
+    if (Array.isArray(inputSchema.required)) {
+        if (!inputSchema.required.includes(parameterName)) inputSchema.required.push(parameterName);
+    } else inputSchema.required = [
+        parameterName
+    ];
+    return modifiedTool;
+}
 function analyticsOwnsParameter(inputSchema, parameterName) {
     if (!inputSchema || 'object' != typeof inputSchema) return canInjectAnalyticsParameter(void 0, parameterName);
     if (isZodRawShapeCompat(inputSchema)) return canInjectAnalyticsParameter({
@@ -36,6 +67,7 @@ function getAnalyticsParameterOwnership(inputSchema, outputSchema) {
     return {
         context: analyticsOwnsParameter(inputSchema, 'context'),
         conversationId: analyticsOwnsParameter(inputSchema, 'conversation_id'),
+        llmModel: analyticsOwnsParameter(inputSchema, 'llm_model'),
         outputInstructions: canDeclareOutputInstructions(outputSchema)
     };
 }
@@ -49,6 +81,10 @@ function stripOwnedAnalyticsArguments(args, ownership) {
         const { conversation_id: _conversationId, ...rest } = cleanedArgs;
         cleanedArgs = rest;
     }
+    if (ownership.llmModel && cleanedArgs && 'object' == typeof cleanedArgs && 'llm_model' in cleanedArgs) {
+        const { llm_model: _llmModel, ...rest } = cleanedArgs;
+        cleanedArgs = rest;
+    }
     return cleanedArgs;
 }
-export { analyticsOwnsParameter, canInjectAnalyticsParameter, getAnalyticsParameterOwnership, hasAnalyticsParameter, stripOwnedAnalyticsArguments };
+export { addAnalyticsParameterToTool, analyticsOwnsParameter, canInjectAnalyticsParameter, getAnalyticsParameterOwnership, hasAnalyticsParameter, stripOwnedAnalyticsArguments };

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,CA0E3B"}
+{"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,CA8E3B"}

package/dist/extensions/capture.js

@@ -1,11 +1,15 @@
 "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__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
     };
 })();
 (()=>{
@@ -13,7 +17,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {
@@ -64,6 +68,8 @@ function captureEvent(server, eventInput, logger, requestAttribution) {
         response: eventInput.response,
         userIntent: eventInput.userIntent,
         userIntentSource: eventInput.userIntentSource,
+        llmModel: eventInput.llmModel,
+        llmModelSource: eventInput.llmModelSource,
         isError: eventInput.isError,
         error: eventInput.error,
         errorType: eventInput.errorType,
@@ -76,9 +82,9 @@ function captureEvent(server, eventInput, logger, requestAttribution) {
     });
 }
 exports.captureEvent = __webpack_exports__.captureEvent;
-for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+for(var __rspack_i in __webpack_exports__)if (-1 === [
     "captureEvent"
-].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true
 });

package/dist/extensions/capture.mjs

@@ -36,6 +36,8 @@ function captureEvent(server, eventInput, logger, requestAttribution) {
         response: eventInput.response,
         userIntent: eventInput.userIntent,
         userIntentSource: eventInput.userIntentSource,
+        llmModel: eventInput.llmModel,
+        llmModelSource: eventInput.llmModelSource,
         isError: eventInput.isError,
         error: eventInput.error,
         errorType: eventInput.errorType,

package/dist/extensions/client-identity.js

@@ -1,11 +1,15 @@
 "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__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
     };
 })();
 (()=>{
@@ -13,7 +17,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {
@@ -24,15 +28,15 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    readMetaClientInfo: ()=>readMetaClientInfo,
-    readHeaderProtocolVersion: ()=>readHeaderProtocolVersion,
+    META_CLIENT_INFO_KEY: ()=>META_CLIENT_INFO_KEY,
     META_PROTOCOL_VERSION_KEY: ()=>META_PROTOCOL_VERSION_KEY,
     PROTOCOL_VERSION_HEADER: ()=>PROTOCOL_VERSION_HEADER,
-    stampClientIdentity: ()=>stampClientIdentity,
-    resolveClientIdentity: ()=>resolveClientIdentity,
-    readServerClientIdentity: ()=>readServerClientIdentity,
     readEnvelopeClientInfo: ()=>readEnvelopeClientInfo,
-    META_CLIENT_INFO_KEY: ()=>META_CLIENT_INFO_KEY
+    readHeaderProtocolVersion: ()=>readHeaderProtocolVersion,
+    readMetaClientInfo: ()=>readMetaClientInfo,
+    readServerClientIdentity: ()=>readServerClientIdentity,
+    resolveClientIdentity: ()=>resolveClientIdentity,
+    stampClientIdentity: ()=>stampClientIdentity
 });
 const external_detect_js_namespaceObject = require("./detect.js");
 const external_headers_js_namespaceObject = require("./headers.js");
@@ -125,7 +129,7 @@ exports.readMetaClientInfo = __webpack_exports__.readMetaClientInfo;
 exports.readServerClientIdentity = __webpack_exports__.readServerClientIdentity;
 exports.resolveClientIdentity = __webpack_exports__.resolveClientIdentity;
 exports.stampClientIdentity = __webpack_exports__.stampClientIdentity;
-for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+for(var __rspack_i in __webpack_exports__)if (-1 === [
     "META_CLIENT_INFO_KEY",
     "META_PROTOCOL_VERSION_KEY",
     "PROTOCOL_VERSION_HEADER",
@@ -135,7 +139,7 @@ for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "readServerClientIdentity",
     "resolveClientIdentity",
     "stampClientIdentity"
-].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true
 });

package/dist/extensions/compatibility.js

@@ -1,11 +1,15 @@
 "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__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
     };
 })();
 (()=>{
@@ -13,7 +17,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {
@@ -24,11 +28,11 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
-    isLowLevelServer: ()=>isLowLevelServer,
-    isHighLevelServer: ()=>isHighLevelServer,
-    logCompatibilityWarning: ()=>logCompatibilityWarning,
+    getMCPCompatibleErrorMessage: ()=>getMCPCompatibleErrorMessage,
     isCompatibleServerType: ()=>isCompatibleServerType,
-    getMCPCompatibleErrorMessage: ()=>getMCPCompatibleErrorMessage
+    isHighLevelServer: ()=>isHighLevelServer,
+    isLowLevelServer: ()=>isLowLevelServer,
+    logCompatibilityWarning: ()=>logCompatibilityWarning
 });
 const external_detect_js_namespaceObject = require("./detect.js");
 function logCompatibilityWarning(logger) {
@@ -96,13 +100,13 @@ 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 === [
+for(var __rspack_i in __webpack_exports__)if (-1 === [
     "getMCPCompatibleErrorMessage",
     "isCompatibleServerType",
     "isHighLevelServer",
     "isLowLevelServer",
     "logCompatibilityWarning"
-].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true
 });

package/dist/extensions/constants.d.ts

@@ -1,5 +1,6 @@
 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_MODEL_PARAMETER_DESCRIPTION = "The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. \"claude-opus-4-8\", \"gpt-5.2\"). Used for analytics only. If you do not know your model identifier with certainty, pass \"unknown\" \u2014 never guess.";
 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 POSTHOG_MCP_LIB_NAME = "posthog-node-mcp";
@@ -29,6 +30,8 @@ export declare const PostHogMCPAnalyticsProperty: {
     readonly Intent: "$mcp_intent";
     readonly IntentSource: "$mcp_intent_source";
     readonly ListedToolNames: "$mcp_listed_tool_names";
+    readonly LlmModel: "$mcp_llm_model";
+    readonly LlmModelSource: "$mcp_llm_model_source";
     readonly Parameters: "$mcp_parameters";
     readonly ProtocolVersion: "$mcp_protocol_version";
     readonly ResourceName: "$mcp_resource_name";

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;;;;;;;;;;;;;;;;;;;;;;;;CAwB9B,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,gRAAqQ,CAAA;AAErT,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;;;;;;;;;;;;;;;;;;;;;;;;;;CA0B9B,CAAA;AAEV,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAA"}

package/dist/extensions/constants.js

@@ -1,11 +1,15 @@
 "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__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
     };
 })();
 (()=>{
@@ -13,7 +17,7 @@ var __webpack_require__ = {};
 })();
 (()=>{
     __webpack_require__.r = (exports1)=>{
-        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
             value: 'Module'
         });
         Object.defineProperty(exports1, '__esModule', {
@@ -23,18 +27,10 @@ var __webpack_require__ = {};
 })();
 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,
-    POSTHOG_MCP_LIB_NAME: ()=>POSTHOG_MCP_LIB_NAME,
-    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 DEFAULT_MODEL_PARAMETER_DESCRIPTION = 'The exact model identifier you (the assistant) are running as, taken from your system prompt or environment (e.g. "claude-opus-4-8", "gpt-5.2"). Used for analytics only. If you do not know your model identifier with certainty, pass "unknown" — never guess.';
+const DEFAULT_CONVERSATION_ID_DESCRIPTION = "Echo the conversation_id from the server's previous response. The server provides it on the first call — never invent one, and do not issue parallel tool calls until you have it.";
 const POSTHOG_MCP_ANALYTICS_SOURCE = 'posthog_mcp_analytics';
 const POSTHOG_MCP_LIB_NAME = 'posthog-node-mcp';
 const PostHogMCPAnalyticsEvent = {
@@ -62,6 +58,8 @@ const PostHogMCPAnalyticsProperty = {
     Intent: '$mcp_intent',
     IntentSource: '$mcp_intent_source',
     ListedToolNames: '$mcp_listed_tool_names',
+    LlmModel: '$mcp_llm_model',
+    LlmModelSource: '$mcp_llm_model_source',
     Parameters: '$mcp_parameters',
     ProtocolVersion: '$mcp_protocol_version',
     ResourceName: '$mcp_resource_name',
@@ -75,22 +73,34 @@ const PostHogMCPAnalyticsProperty = {
     ToolName: '$mcp_tool_name',
     VendorClient: '$mcp_vendor_client'
 };
+__webpack_require__.d(__webpack_exports__, {}, {
+    DEFAULT_CONTEXT_PARAMETER_DESCRIPTION: DEFAULT_CONTEXT_PARAMETER_DESCRIPTION,
+    DEFAULT_CONVERSATION_ID_DESCRIPTION: DEFAULT_CONVERSATION_ID_DESCRIPTION,
+    DEFAULT_MODEL_PARAMETER_DESCRIPTION: DEFAULT_MODEL_PARAMETER_DESCRIPTION,
+    INACTIVITY_TIMEOUT_IN_MINUTES: INACTIVITY_TIMEOUT_IN_MINUTES,
+    POSTHOG_MCP_ANALYTICS_SOURCE: POSTHOG_MCP_ANALYTICS_SOURCE,
+    POSTHOG_MCP_LIB_NAME: POSTHOG_MCP_LIB_NAME,
+    PostHogMCPAnalyticsEvent: PostHogMCPAnalyticsEvent,
+    PostHogMCPAnalyticsProperty: PostHogMCPAnalyticsProperty
+});
 exports.DEFAULT_CONTEXT_PARAMETER_DESCRIPTION = __webpack_exports__.DEFAULT_CONTEXT_PARAMETER_DESCRIPTION;
 exports.DEFAULT_CONVERSATION_ID_DESCRIPTION = __webpack_exports__.DEFAULT_CONVERSATION_ID_DESCRIPTION;
+exports.DEFAULT_MODEL_PARAMETER_DESCRIPTION = __webpack_exports__.DEFAULT_MODEL_PARAMETER_DESCRIPTION;
 exports.INACTIVITY_TIMEOUT_IN_MINUTES = __webpack_exports__.INACTIVITY_TIMEOUT_IN_MINUTES;
 exports.POSTHOG_MCP_ANALYTICS_SOURCE = __webpack_exports__.POSTHOG_MCP_ANALYTICS_SOURCE;
 exports.POSTHOG_MCP_LIB_NAME = __webpack_exports__.POSTHOG_MCP_LIB_NAME;
 exports.PostHogMCPAnalyticsEvent = __webpack_exports__.PostHogMCPAnalyticsEvent;
 exports.PostHogMCPAnalyticsProperty = __webpack_exports__.PostHogMCPAnalyticsProperty;
-for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+for(var __rspack_i in __webpack_exports__)if (-1 === [
     "DEFAULT_CONTEXT_PARAMETER_DESCRIPTION",
     "DEFAULT_CONVERSATION_ID_DESCRIPTION",
+    "DEFAULT_MODEL_PARAMETER_DESCRIPTION",
     "INACTIVITY_TIMEOUT_IN_MINUTES",
     "POSTHOG_MCP_ANALYTICS_SOURCE",
     "POSTHOG_MCP_LIB_NAME",
     "PostHogMCPAnalyticsEvent",
     "PostHogMCPAnalyticsProperty"
-].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
 Object.defineProperty(exports, '__esModule', {
     value: true
 });