@posthog/mcp 0.11.6 → 0.12.0

package/README.md

@@ -149,6 +149,35 @@ 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.
+
 ### 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

@@ -24,12 +24,14 @@ var __webpack_require__ = {};
 var __webpack_exports__ = {};
 __webpack_require__.r(__webpack_exports__);
 __webpack_require__.d(__webpack_exports__, {
+    addAnalyticsParameterToTool: ()=>addAnalyticsParameterToTool,
     hasAnalyticsParameter: ()=>hasAnalyticsParameter,
     analyticsOwnsParameter: ()=>analyticsOwnsParameter,
     getAnalyticsParameterOwnership: ()=>getAnalyticsParameterOwnership,
     canInjectAnalyticsParameter: ()=>canInjectAnalyticsParameter,
     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 +52,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 +100,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,14 +114,20 @@ 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 === [
+    "addAnalyticsParameterToTool",
     "analyticsOwnsParameter",
     "canInjectAnalyticsParameter",
     "getAnalyticsParameterOwnership",

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

@@ -64,6 +64,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/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/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

@@ -26,6 +26,7 @@ __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,
+    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,
@@ -34,6 +35,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 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_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" \u{2014} 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 \u2014 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';
@@ -62,6 +64,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',
@@ -77,6 +81,7 @@ const 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;
@@ -85,6 +90,7 @@ exports.PostHogMCPAnalyticsProperty = __webpack_exports__.PostHogMCPAnalyticsPro
 for(var __webpack_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",

package/dist/extensions/constants.mjs

@@ -1,5 +1,6 @@
 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_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" \u{2014} 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 \u2014 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';
@@ -28,6 +29,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',
@@ -41,4 +44,4 @@ const PostHogMCPAnalyticsProperty = {
     ToolName: '$mcp_tool_name',
     VendorClient: '$mcp_vendor_client'
 };
-export { DEFAULT_CONTEXT_PARAMETER_DESCRIPTION, DEFAULT_CONVERSATION_ID_DESCRIPTION, INACTIVITY_TIMEOUT_IN_MINUTES, POSTHOG_MCP_ANALYTICS_SOURCE, POSTHOG_MCP_LIB_NAME, PostHogMCPAnalyticsEvent, PostHogMCPAnalyticsProperty };
+export { 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 };

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

@@ -9,8 +9,8 @@ export interface ContextInjectableTool {
 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,
+ * Adds a context parameter to a tool's JSON Schema, via the shared injector.
+ * This 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:

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

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

package/dist/extensions/context-parameters.js

@@ -39,35 +39,7 @@ function getContextDescription(context) {
     return 'object' == typeof context ? context.description : void 0;
 }
 function addContextParameterToTool(tool, contextDescriptionOverride, logger = external_logger_js_namespaceObject.log) {
-    const modifiedTool = {
-        ...tool
-    };
-    const toolName = tool.name || 'unknown';
-    const schema = modifiedTool.inputSchema;
-    if (!(0, external_analytics_parameters_js_namespaceObject.canInjectAnalyticsParameter)(schema, 'context')) {
-        logger((0, external_analytics_parameters_js_namespaceObject.hasAnalyticsParameter)(schema, 'context') ? `WARN: Tool "${toolName}" already has 'context' parameter. Skipping context injection.` : `WARN: Tool "${toolName}" has complex schema (oneOf/allOf/anyOf/$ref). 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;
+    return (0, external_analytics_parameters_js_namespaceObject.addAnalyticsParameterToTool)(tool, 'context', contextDescriptionOverride || external_constants_js_namespaceObject.DEFAULT_CONTEXT_PARAMETER_DESCRIPTION, 'context', logger);
 }
 function addContextParameterToTools(tools, contextDescriptionOverride, logger = external_logger_js_namespaceObject.log) {
     return tools.map((tool)=>addContextParameterToTool(tool, contextDescriptionOverride, logger));

package/dist/extensions/context-parameters.mjs

@@ -1,4 +1,4 @@
-import { canInjectAnalyticsParameter, hasAnalyticsParameter } from "./analytics-parameters.mjs";
+import { addAnalyticsParameterToTool } from "./analytics-parameters.mjs";
 import { DEFAULT_CONTEXT_PARAMETER_DESCRIPTION } from "./constants.mjs";
 import { log } from "./logger.mjs";
 function isContextEnabled(context) {
@@ -8,35 +8,7 @@ function getContextDescription(context) {
     return 'object' == typeof context ? context.description : void 0;
 }
 function addContextParameterToTool(tool, contextDescriptionOverride, logger = log) {
-    const modifiedTool = {
-        ...tool
-    };
-    const toolName = tool.name || 'unknown';
-    const schema = modifiedTool.inputSchema;
-    if (!canInjectAnalyticsParameter(schema, 'context')) {
-        logger(hasAnalyticsParameter(schema, 'context') ? `WARN: Tool "${toolName}" already has 'context' parameter. Skipping context injection.` : `WARN: Tool "${toolName}" has complex schema (oneOf/allOf/anyOf/$ref). Skipping context injection.`);
-        return modifiedTool;
-    }
-    if (!modifiedTool.inputSchema) modifiedTool.inputSchema = {
-        type: 'object',
-        properties: {},
-        required: []
-    };
-    const contextDescription = contextDescriptionOverride || 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;
+    return addAnalyticsParameterToTool(tool, 'context', contextDescriptionOverride || DEFAULT_CONTEXT_PARAMETER_DESCRIPTION, 'context', logger);
 }
 function addContextParameterToTools(tools, contextDescriptionOverride, logger = log) {
     return tools.map((tool)=>addContextParameterToTool(tool, contextDescriptionOverride, logger));

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

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

package/dist/extensions/conversation-id.js

@@ -102,7 +102,9 @@ function stripConversationId(args) {
 function buildConversationIdPromptBack(conversationId) {
     return {
         type: 'text',
-        text: `[SERVER]: Reuse conversation_id=${conversationId} on every subsequent tool call in this conversation. Required for the server to correlate calls and provide context-aware results.`
+        text: JSON.stringify({
+            conversation_id: conversationId
+        })
     };
 }
 function injectConversationIdPromptBack(result, conversationId) {

package/dist/extensions/conversation-id.mjs

@@ -66,7 +66,9 @@ function stripConversationId(args) {
 function buildConversationIdPromptBack(conversationId) {
     return {
         type: 'text',
-        text: `[SERVER]: Reuse conversation_id=${conversationId} on every subsequent tool call in this conversation. Required for the server to correlate calls and provide context-aware results.`
+        text: JSON.stringify({
+            conversation_id: conversationId
+        })
     };
 }
 function injectConversationIdPromptBack(result, conversationId) {

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

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

package/dist/extensions/instrument-highlevel.js

@@ -28,6 +28,7 @@ __webpack_require__.d(__webpack_exports__, {
 });
 const external_analytics_parameters_js_namespaceObject = require("./analytics-parameters.js");
 const external_context_parameters_js_namespaceObject = require("./context-parameters.js");
+const external_model_parameters_js_namespaceObject = require("./model-parameters.js");
 const external_event_types_js_namespaceObject = require("./event-types.js");
 const external_internal_js_namespaceObject = require("./internal.js");
 const external_mcp_sdk_compat_js_namespaceObject = require("./mcp-sdk-compat.js");
@@ -128,7 +129,8 @@ function addTracingToToolCallbackInternal(tool, toolName, server, getCurrentInpu
         const inputSchema = getCurrentInputSchema();
         const cleanedArgs = (0, external_analytics_parameters_js_namespaceObject.stripOwnedAnalyticsArguments)(args, {
             context: (0, external_context_parameters_js_namespaceObject.isContextEnabled)(options?.context) && (0, external_analytics_parameters_js_namespaceObject.analyticsOwnsParameter)(inputSchema, 'context'),
-            conversationId: options?.enableConversationId === true && (0, external_analytics_parameters_js_namespaceObject.analyticsOwnsParameter)(inputSchema, 'conversation_id')
+            conversationId: options?.enableConversationId === true && (0, external_analytics_parameters_js_namespaceObject.analyticsOwnsParameter)(inputSchema, 'conversation_id'),
+            llmModel: (0, external_model_parameters_js_namespaceObject.isCaptureModelEnabled)(options?.captureModel) && (0, external_analytics_parameters_js_namespaceObject.analyticsOwnsParameter)(inputSchema, 'llm_model')
         });
         try {
             if (void 0 === cleanedArgs) {
@@ -165,6 +167,7 @@ async function handleToolCallRequest(highLevelServer, server, originalCallToolHa
             extra,
             eventType: external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpMissingCapability,
             explicitContextIntent: context,
+            parameterOwnership: (0, external_instrumentation_js_namespaceObject.getVirtualToolParameterOwnership)(data, toolName),
             execute: async ()=>(0, external_tools_js_namespaceObject.handleReportMissing)({
                     context
                 }, data.logger)

package/dist/extensions/instrument-highlevel.mjs

@@ -1,10 +1,11 @@
 import { analyticsOwnsParameter, getAnalyticsParameterOwnership, stripOwnedAnalyticsArguments } from "./analytics-parameters.mjs";
 import { isContextEnabled } from "./context-parameters.mjs";
+import { isCaptureModelEnabled } from "./model-parameters.mjs";
 import { MCPAnalyticsEventType } from "./event-types.mjs";
 import { getServerTrackingData } from "./internal.mjs";
 import { createWrappedTool, getToolFunction, hasToolFunction } from "./mcp-sdk-compat.mjs";
 import { handleReportMissing, resolveMissingCapabilityToolName } from "./tools.mjs";
-import { captureToolCall, handleInitializeRequest, handleListToolsRequest, isToolAdvertised, patchRequestHandlers, readToolMetaCategory } from "./instrumentation.mjs";
+import { captureToolCall, getVirtualToolParameterOwnership, handleInitializeRequest, handleListToolsRequest, isToolAdvertised, patchRequestHandlers, readToolMetaCategory } from "./instrumentation.mjs";
 import { getContextArgument } from "./tracing-helpers.mjs";
 const wrappedCallbacks = new WeakMap();
 const MCP_ANALYTICS_PROCESSED = Symbol('__posthog_mcp_analytics_processed__');
@@ -100,7 +101,8 @@ function addTracingToToolCallbackInternal(tool, toolName, server, getCurrentInpu
         const inputSchema = getCurrentInputSchema();
         const cleanedArgs = stripOwnedAnalyticsArguments(args, {
             context: isContextEnabled(options?.context) && analyticsOwnsParameter(inputSchema, 'context'),
-            conversationId: options?.enableConversationId === true && analyticsOwnsParameter(inputSchema, 'conversation_id')
+            conversationId: options?.enableConversationId === true && analyticsOwnsParameter(inputSchema, 'conversation_id'),
+            llmModel: isCaptureModelEnabled(options?.captureModel) && analyticsOwnsParameter(inputSchema, 'llm_model')
         });
         try {
             if (void 0 === cleanedArgs) {
@@ -137,6 +139,7 @@ async function handleToolCallRequest(highLevelServer, server, originalCallToolHa
             extra,
             eventType: MCPAnalyticsEventType.mcpMissingCapability,
             explicitContextIntent: context,
+            parameterOwnership: getVirtualToolParameterOwnership(data, toolName),
             execute: async ()=>handleReportMissing({
                     context
                 }, data.logger)

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

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

package/dist/extensions/instrument-lowlevel.js

@@ -67,6 +67,7 @@ async function handleToolCallRequest(server, originalCallToolHandler, request, e
             extra,
             eventType: external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpMissingCapability,
             explicitContextIntent: context,
+            parameterOwnership: (0, external_instrumentation_js_namespaceObject.getVirtualToolParameterOwnership)(data, toolName),
             execute: async ()=>(0, external_tools_js_namespaceObject.handleReportMissing)({
                     context
                 }, data.logger)

package/dist/extensions/instrument-lowlevel.mjs

@@ -1,7 +1,7 @@
 import { MCPAnalyticsEventType } from "./event-types.mjs";
 import { getServerTrackingData } from "./internal.mjs";
 import { handleReportMissing, resolveMissingCapabilityToolName } from "./tools.mjs";
-import { captureToolCall, handleInitializeRequest, handleListToolsRequest, isToolAdvertised, patchRequestHandlers, registerFallbackRequestHandler } from "./instrumentation.mjs";
+import { captureToolCall, getVirtualToolParameterOwnership, handleInitializeRequest, handleListToolsRequest, isToolAdvertised, patchRequestHandlers, registerFallbackRequestHandler } from "./instrumentation.mjs";
 import { getContextArgument } from "./tracing-helpers.mjs";
 function instrumentLowLevelServer(server, logger) {
     try {
@@ -39,6 +39,7 @@ async function handleToolCallRequest(server, originalCallToolHandler, request, e
             extra,
             eventType: MCPAnalyticsEventType.mcpMissingCapability,
             explicitContextIntent: context,
+            parameterOwnership: getVirtualToolParameterOwnership(data, toolName),
             execute: async ()=>handleReportMissing({
                     context
                 }, data.logger)

package/dist/extensions/instrumentation.d.ts

@@ -84,6 +84,22 @@ export declare function registerFallbackRequestHandler(server: MCPServerLike, ha
  * bare server to instrument() and only then registers its handlers.
  */
 export declare function patchRequestHandlers(server: MCPServerLike, patches: Record<string, HandlerPatch>): void;
+/**
+ * Ownership for the `get_more_tools` virtual tool, resolved without the
+ * `tools/list` cache.
+ *
+ * The missing-capability branch is only entered when the application does not
+ * advertise a tool by this name, so the descriptor is the SDK's own and what it
+ * declares is known statically. An instance that never served a listing — a
+ * per-request `McpServer`/`Server`, the topology in ADR-0011 — would otherwise
+ * read every injected parameter as not-ours and neither capture nor strip it.
+ *
+ * `conversation_id` still comes from the cache on purpose: resolving it here too
+ * would start minting a handle, and appending its prompt-back block, on
+ * instances that today mint none. That changes session anchoring (ADR-0004)
+ * rather than closing this gap.
+ */
+export declare function getVirtualToolParameterOwnership(data: MCPAnalyticsData, toolName: string): AnalyticsParameterOwnership;
 /**
  * Checks the server's raw listing for a real owner of a candidate virtual tool.
  * This does not depend on a previous client request and does not call the

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

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/extensions/instrumentation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/extensions/instrumentation.ts"],"names":[],"mappings":"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"}