@posthog/mcp 0.16.4 → 0.18.0

package/README.md

@@ -80,7 +80,7 @@ Protocol revision is a property of each **request**, not of the server: a v2 ser
 
 - **On `2026-07-28`** there is no `initialize` and no session header — the revision removed
   protocol-level sessions, and this SDK will not mint one. Session correlation therefore comes from
-  `enableConversationId`, which is **opt-in**. Without it every request is its own `$session_id`.
+  `enableConversationId`, which is **on by default**. Without it every request is its own `$session_id`.
   The `get_more_tools` and `send_feedback` virtual tools also use this handle, including calls handled
   by a fresh server instance.
 - **On `2025-11-25`**, the session id and the client's name and version are exchanged once at
@@ -160,9 +160,31 @@ over-redacting ordinary prose. It also applies only to `$mcp_intent`: structured
 results are left as-is, because the same shapes are often legitimate data there. If you need a stronger
 guarantee, `context: false` and the `beforeSend` hook above remain the ways to drop the field entirely.
 
+### Defaults and opt-outs
+
+On fresh low-level instances, tools with an `outputSchema` deliver new handles through `content` only. Clients that consume only `structuredContent` will not echo those handles, so correlation is not guaranteed for that combination. Unknown ownership can also cause a prompt-back block to be appended for a schema that discovery would not extend; disable `enableConversationId` if that contract is unsuitable.
+
+A valid echoed conversation handle takes precedence over transport sessions. A request that already carries a transport session or a PostHog session token does not mint a new handle or append a prompt-back block. Requests carrying neither use the conversation fallback.
+
+Intent, model capture, conversation correlation, and exception capture are enabled by default.
+Missing-capability reporting and feedback collection remain disabled.
+
+```ts
+instrument(server, posthog, { captureModel: false, enableConversationId: false })
+```
+
+Model capture adds a required `llm_model` argument to compatible tool schemas. Dispatch never
+enforces it, so servers keep working; strict-schema clients see the new field. Set
+`captureModel: false` to leave schemas untouched. Conversation correlation adds an optional
+`conversation_id` argument and returns a handle in eligible tool results. Clients must echo that
+handle to group later calls; calls without it mint new handles. Set `enableConversationId: false`
+to retain transport-based session grouping and unchanged response content. Custom `PostHogMCP`
+dispatchers also enable model capture and conversation correlation by default.
+The reasoning behind these defaults is in [ADR-0013](./docs/adr/0013-analytics-capture-is-on-by-default.md).
+
 ### What `$mcp_llm_model` records, and when it stays empty
 
-`captureModel` is **off** by default. Turn it on and the SDK records the best model id visible to the
+`captureModel` is **on** by default. The SDK records the best model id visible to the
 server as `$mcp_llm_model`. Recognized client metadata wins with source `client_metadata`. Otherwise,
 the SDK injects a required `llm_model` parameter and records the answer with source `self_reported`.
 
@@ -173,47 +195,62 @@ Missing, blank, and `unknown` values are recorded as nothing.
 The recognized metadata path is Codex's `x-codex-turn-metadata.model` field inside request `_meta`.
 Other clients keep using self-report until they expose a stable model field.
 
-Unlike `context`, the self-report fallback degrades to **silence** rather than to a kept argument.
-Its capture and stripping require the SDK to have confirmed the parameter is its own:
+Like `context`, self-report follows the ownership rule of ADR-0011: reading `llm_model` fails
+open where the SDK cannot tell who declared it, stripping it requires proof that the SDK did:
 
 - `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.
+- Instrumenting a low-level `Server` learns ownership while serving `tools/list`. A fresh instance
+  that never served one — `createMcpHandler`, or `@rekog/mcp-nest` in its stateless mode — has no
+  answer, so it records `llm_model` as the self-reported model and strips nothing. A tool that
+  declares its own `llm_model` on such an instance is therefore recorded under `$mcp_llm_model`
+  until a listing says otherwise; `captureModel: false` or dropping the property in `beforeSend`
+  are the escapes. The SDK never replays your listing handler on the call path to find out.
 
 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:
+For a custom dispatcher, `PostHogMCP` enables model capture and conversation correlation by default.
+`prepareToolList()` injects the analytics fields and records ownership by tool name.
+`prepareToolCall()` removes SDK-owned arguments and resolves the conversation and session.
+`prepareToolResult()` returns the result to send and the final values to capture. 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 posthog = new PostHogMCP(process.env.POSTHOG_PROJECT_TOKEN)
 
 const tools = posthog.prepareToolList(serverTools)
 const originalTool = serverTools.find((tool) => tool.name === toolName)
-const { args, llmModel, llmModelSource } = posthog.prepareToolCall(toolName, rawArgs, {
+const preparedCall = posthog.prepareToolCall(toolName, rawArgs, {
   originalTool,
   requestMeta: request.params?._meta,
+  sessionId: transportSessionId,
+})
+const toolResult = await dispatch(toolName, preparedCall.args)
+const preparedResult = posthog.prepareToolResult(toolResult, preparedCall)
+
+posthog.captureToolCall({
+  toolName,
+  llmModel: preparedCall.llmModel,
+  llmModelSource: preparedCall.llmModelSource,
+  sessionId: preparedResult.sessionId,
+  conversationId: preparedResult.conversationId,
+  isError: false,
 })
-const result = await dispatch(toolName, args)
 
-posthog.captureToolCall({ toolName, llmModel, llmModelSource, isError: false })
+return preparedResult.result
 ```
 
 A persistent single-process dispatcher can omit `originalTool` after it has prepared its tool list.
 Pass `requestMeta` whenever the request supplies `_meta`; this enables recognized client metadata
-without changing the arguments sent to the tool.
+without changing the arguments sent to the tool. Pass an existing transport or request session as
+`sessionId`. A valid echoed conversation handle takes precedence. Otherwise, the existing session
+prevents a new handle from being minted. Set `enableConversationId: false` on `PostHogMCP` to keep
+the previous custom-dispatcher behavior.
 
 ### Collecting agent feedback (`send_feedback`)
 
@@ -266,11 +303,17 @@ return { tools: posthog.prepareToolList(myTools, { collectFeedback: true }) }
 
 // tools/call dispatcher
 const originalTool = myTools.find((tool) => tool.name === name)
-const prepared = posthog.prepareToolCall(name, rawArgs, { originalTool })
-if (prepared.isFeedback) {
-  posthog.captureFeedback({ report: prepared.feedbackReport!, ...identity })
-  await myFeedbackBackend.record(prepared.feedbackReport!)
-  return sendFeedbackResult() // or a custom text reply
+const preparedCall = posthog.prepareToolCall(name, rawArgs, { originalTool })
+if (preparedCall.isFeedback) {
+  await myFeedbackBackend.record(preparedCall.feedbackReport!)
+  const preparedResult = posthog.prepareToolResult(sendFeedbackResult(), preparedCall)
+  posthog.captureFeedback({
+    report: preparedCall.feedbackReport!,
+    sessionId: preparedResult.sessionId,
+    conversationId: preparedResult.conversationId,
+    ...identity,
+  })
+  return preparedResult.result
 }
 ```
 

package/dist/extensions/constants.d.ts

@@ -5,54 +5,54 @@ export declare const DEFAULT_CONVERSATION_ID_DESCRIPTION = "Echo the conversatio
 export declare const POSTHOG_MCP_ANALYTICS_SOURCE = "posthog_mcp_analytics";
 export declare const POSTHOG_MCP_LIB_NAME = "posthog-node-mcp";
 export declare const PostHogMCPAnalyticsEvent: {
-    readonly Custom: "$mcp_custom";
-    readonly Exception: "$exception";
-    readonly Feedback: "$mcp_feedback";
-    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";
+    readonly Custom: '$mcp_custom';
+    readonly Exception: '$exception';
+    readonly Feedback: '$mcp_feedback';
+    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 ClientUserAgent: "$mcp_client_user_agent";
-    readonly ClientVersion: "$mcp_client_version";
-    readonly ConversationId: "$mcp_conversation_id";
-    readonly DurationMs: "$mcp_duration_ms";
-    readonly ErrorMessage: "$mcp_error_message";
-    readonly ErrorType: "$mcp_error_type";
-    readonly FeedbackDetails: "$mcp_feedback_details";
-    readonly FeedbackFrictionPoints: "$mcp_feedback_friction_points";
-    readonly FeedbackSentiment: "$mcp_feedback_sentiment";
-    readonly FeedbackSuggestedImprovement: "$mcp_feedback_suggested_improvement";
-    readonly FeedbackSummary: "$mcp_feedback_summary";
-    readonly FeedbackTaskCompleted: "$mcp_feedback_task_completed";
-    readonly FeedbackTool: "$mcp_feedback_tool";
-    readonly FeedbackType: "$mcp_feedback_type";
-    readonly IsError: "$mcp_is_error";
-    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";
-    readonly Response: "$mcp_response";
-    readonly ServerName: "$mcp_server_name";
-    readonly ServerVersion: "$mcp_server_version";
-    readonly SessionId: "$session_id";
-    readonly Source: "$mcp_source";
-    readonly ToolCategory: "$mcp_tool_category";
-    readonly ToolDescription: "$mcp_tool_description";
-    readonly ToolName: "$mcp_tool_name";
-    readonly VendorClient: "$mcp_vendor_client";
+    readonly ClientName: '$mcp_client_name';
+    readonly ClientUserAgent: '$mcp_client_user_agent';
+    readonly ClientVersion: '$mcp_client_version';
+    readonly ConversationId: '$mcp_conversation_id';
+    readonly DurationMs: '$mcp_duration_ms';
+    readonly ErrorMessage: '$mcp_error_message';
+    readonly ErrorType: '$mcp_error_type';
+    readonly FeedbackDetails: '$mcp_feedback_details';
+    readonly FeedbackFrictionPoints: '$mcp_feedback_friction_points';
+    readonly FeedbackSentiment: '$mcp_feedback_sentiment';
+    readonly FeedbackSuggestedImprovement: '$mcp_feedback_suggested_improvement';
+    readonly FeedbackSummary: '$mcp_feedback_summary';
+    readonly FeedbackTaskCompleted: '$mcp_feedback_task_completed';
+    readonly FeedbackTool: '$mcp_feedback_tool';
+    readonly FeedbackType: '$mcp_feedback_type';
+    readonly IsError: '$mcp_is_error';
+    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';
+    readonly Response: '$mcp_response';
+    readonly ServerName: '$mcp_server_name';
+    readonly ServerVersion: '$mcp_server_version';
+    readonly SessionId: '$session_id';
+    readonly Source: '$mcp_source';
+    readonly ToolCategory: '$mcp_tool_category';
+    readonly ToolDescription: '$mcp_tool_description';
+    readonly ToolName: '$mcp_tool_name';
+    readonly VendorClient: '$mcp_vendor_client';
 };
 export type PostHogMCPAnalyticsProperty = (typeof PostHogMCPAnalyticsProperty)[keyof typeof PostHogMCPAnalyticsProperty];
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/extensions/constants.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,6BAA6B,KAAK,CAAA;AAE/C,eAAO,MAAM,qCAAqC,onBAA4mB,CAAA;AAE9pB,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;;;;;;;;;;;;;CAa3B,CAAA;AAEV,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAA;AAE/G,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkC9B,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,onBAA4mB,CAAA;AAE9pB,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;aACnC,MAAM,EAAE,aAAa;aACrB,SAAS,EAAE,YAAY;aACvB,QAAQ,EAAE,eAAe;aACzB,QAAQ,EAAE,WAAW;aACrB,UAAU,EAAE,iBAAiB;aAC7B,iBAAiB,EAAE,yBAAyB;aAC5C,SAAS,EAAE,iBAAiB;aAC5B,WAAW,EAAE,mBAAmB;aAChC,YAAY,EAAE,oBAAoB;aAClC,aAAa,EAAE,qBAAqB;aACpC,QAAQ,EAAE,gBAAgB;aAC1B,SAAS,EAAE,iBAAiB;CACpB,CAAA;AAEV,MAAM,MAAM,wBAAwB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,OAAO,wBAAwB,CAAC,CAAA;AAE/G,eAAO,MAAM,2BAA2B;aACtC,UAAU,EAAE,kBAAkB;aAC9B,eAAe,EAAE,wBAAwB;aACzC,aAAa,EAAE,qBAAqB;aACpC,cAAc,EAAE,sBAAsB;aACtC,UAAU,EAAE,kBAAkB;aAC9B,YAAY,EAAE,oBAAoB;aAClC,SAAS,EAAE,iBAAiB;aAC5B,eAAe,EAAE,uBAAuB;aACxC,sBAAsB,EAAE,+BAA+B;aACvD,iBAAiB,EAAE,yBAAyB;aAC5C,4BAA4B,EAAE,qCAAqC;aACnE,eAAe,EAAE,uBAAuB;aACxC,qBAAqB,EAAE,8BAA8B;aACrD,YAAY,EAAE,oBAAoB;aAClC,YAAY,EAAE,oBAAoB;aAClC,OAAO,EAAE,eAAe;aACxB,MAAM,EAAE,aAAa;aACrB,YAAY,EAAE,oBAAoB;aAClC,eAAe,EAAE,wBAAwB;aACzC,QAAQ,EAAE,gBAAgB;aAC1B,cAAc,EAAE,uBAAuB;aACvC,UAAU,EAAE,iBAAiB;aAC7B,eAAe,EAAE,uBAAuB;aACxC,YAAY,EAAE,oBAAoB;aAClC,QAAQ,EAAE,eAAe;aACzB,UAAU,EAAE,kBAAkB;aAC9B,aAAa,EAAE,qBAAqB;aACpC,SAAS,EAAE,aAAa;aACxB,MAAM,EAAE,aAAa;aACrB,YAAY,EAAE,oBAAoB;aAClC,eAAe,EAAE,uBAAuB;aACxC,QAAQ,EAAE,gBAAgB;aAC1B,YAAY,EAAE,oBAAoB;CAC1B,CAAA;AAEV,MAAM,MAAM,2BAA2B,GAAG,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,OAAO,2BAA2B,CAAC,CAAA"}

package/dist/extensions/event-types.d.ts

@@ -6,17 +6,17 @@
  * event names.
  */
 export declare const MCPAnalyticsEventType: {
-    readonly identify: "posthog:identify";
-    readonly custom: "posthog:custom";
-    readonly mcpFeedback: "mcp:feedback";
-    readonly mcpMissingCapability: "mcp:missing_capability";
-    readonly mcpInitialize: "mcp:initialize";
-    readonly mcpPromptsGet: "mcp:prompts/get";
-    readonly mcpPromptsList: "mcp:prompts/list";
-    readonly mcpResourcesList: "mcp:resources/list";
-    readonly mcpResourcesRead: "mcp:resources/read";
-    readonly mcpToolsCall: "mcp:tools/call";
-    readonly mcpToolsList: "mcp:tools/list";
+    readonly identify: 'posthog:identify';
+    readonly custom: 'posthog:custom';
+    readonly mcpFeedback: 'mcp:feedback';
+    readonly mcpMissingCapability: 'mcp:missing_capability';
+    readonly mcpInitialize: 'mcp:initialize';
+    readonly mcpPromptsGet: 'mcp:prompts/get';
+    readonly mcpPromptsList: 'mcp:prompts/list';
+    readonly mcpResourcesList: 'mcp:resources/list';
+    readonly mcpResourcesRead: 'mcp:resources/read';
+    readonly mcpToolsCall: 'mcp:tools/call';
+    readonly mcpToolsList: 'mcp:tools/list';
 };
 export type MCPAnalyticsEventType = (typeof MCPAnalyticsEventType)[keyof typeof MCPAnalyticsEventType];
 //# sourceMappingURL=event-types.d.ts.map

package/dist/extensions/event-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../src/extensions/event-types.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;CAYxB,CAAA;AAEV,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAA"}
+{"version":3,"file":"event-types.d.ts","sourceRoot":"","sources":["../../src/extensions/event-types.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB;aAChC,QAAQ,EAAE,kBAAkB;aAC5B,MAAM,EAAE,gBAAgB;aACxB,WAAW,EAAE,cAAc;aAC3B,oBAAoB,EAAE,wBAAwB;aAC9C,aAAa,EAAE,gBAAgB;aAC/B,aAAa,EAAE,iBAAiB;aAChC,cAAc,EAAE,kBAAkB;aAClC,gBAAgB,EAAE,oBAAoB;aACtC,gBAAgB,EAAE,oBAAoB;aACtC,YAAY,EAAE,gBAAgB;aAC9B,YAAY,EAAE,gBAAgB;CACtB,CAAA;AAEV,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAA"}

package/dist/extensions/feedback.d.ts

@@ -1,6 +1,6 @@
 import type { CollectFeedbackOptions, FeedbackReport, CollectFeedbackConfig, CompatibleTextToolResult, CompatibleToolsListLike, JsonRecord } from '../types';
 import { type LoggerFn } from './logger';
-export declare const SEND_FEEDBACK_TOOL_NAME: "send_feedback";
+export declare const SEND_FEEDBACK_TOOL_NAME: 'send_feedback';
 type FeedbackToolDescriptor = CompatibleToolsListLike['tools'][number];
 /** `collectFeedback` normalized to its object form; `undefined` when the feature is off. */
 export declare function resolveCollectFeedbackOptions(config: CollectFeedbackConfig | undefined): CollectFeedbackOptions | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/extensions/instrumentation.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,2BAA2B,EAC3B,6BAA6B,EAC7B,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,aAAa,EAId,MAAM,UAAU,CAAA;AAqBjB,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAIrD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAUxC;;;;;;GAMG;AAEH,KAAK,iBAAiB,GAAG,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,6BAA6B,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAE7G,2EAA2E;AAC3E,KAAK,YAAY,GAAG,CAAC,iBAAiB,EAAE,cAAc,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;AAE3E,UAAU,mBAAmB;IAC3B,MAAM,EAAE,aAAa,CAAA;IACrB,IAAI,EAAE,gBAAgB,CAAA;IACtB,OAAO,EAAE,cAAc,CAAA;IACvB,KAAK,CAAC,EAAE,6BAA6B,CAAA;IACrC,OAAO,EAAE,YAAY,CAAA;IACrB,2FAA2F;IAC3F,kBAAkB,CAAC,EAAE,2BAA2B,CAAA;IAChD;;;;;OAKG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAA;IACjC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;OAGG;IACH,oBAAoB,CAAC,EAAE,UAAU,CAAA;IACjC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAA;CAClC;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CA2EnF;AA4OD,KAAK,iBAAiB,GAAG,OAAO,qBAAqB,CAAC,gBAAgB,GAAG,OAAO,qBAAqB,CAAC,gBAAgB,CAAA;AAuDtH,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,iBAAiB,EAAE,MAAM,EAAE,QAAQ,GAAG,YAAY,CAGjG;AAgDD;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG,CACzB,MAAM,EAAE,aAAa,EACrB,eAAe,EAAE,iBAAiB,EAClC,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,6BAA6B,GAAG,SAAS,KAC7C,OAAO,CAAC,OAAO,CAAC,CAAA;AAkBrB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,aAAa,EACrB,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,iBAAiB,EAClC,KAAK,EAAE,YAAY,GAClB,IAAI,CAGN;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CA0CvG;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,6BAA6B,GAAG,SAAS,EAChD,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAoB9B;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,aAAa,EACrB,wBAAwB,EAAE,iBAAiB,EAC3C,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,6BAA6B,GAAG,SAAS,EAChD,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,uBAAuB,CAAC,CAmElC;AAoID,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,SAAS,GAClD,IAAI,CASN;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,KAAK,EAAE,uBAAuB,CAAC,OAAO,CAAC,GAAG,SAAS,GAClD,IAAI,CAUN;AAuHD;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,aAAa,EACrB,yBAAyB,EAAE,iBAAiB,EAC5C,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,6BAA6B,GAAG,SAAS,EAChD,MAAM,EAAE,QAAQ,GACf,OAAO,CAAC,OAAO,CAAC,CA2ElB"}
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/extensions/instrumentation.ts"],"names":[],"mappings":"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"}

package/dist/extensions/instrumentation.js

@@ -64,9 +64,9 @@ async function captureToolCall(params) {
     const resolvedEventType = eventType ?? external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpToolsCall;
     const isVirtualAnalyticsTool = resolvedEventType === external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpMissingCapability || resolvedEventType === external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpFeedback;
     const ownership = getActiveAnalyticsParameterOwnership(data, request.params?.name, parameterOwnership, isVirtualAnalyticsTool);
-    const canCaptureContextIntent = !isVirtualAnalyticsTool && (0, external_context_parameters_js_namespaceObject.isContextEnabled)(data.options.context) && (ownership.context || !ownership.contextOwnershipKnown);
-    const conversation = (0, external_conversation_id_js_namespaceObject.resolveConversationId)(ownership.conversationId, request.params?.arguments);
-    const downstreamRequest = cloneRequestWithoutOwnedAnalyticsArguments(request, ownership);
+    const canCaptureContextIntent = ownership.read.context;
+    const conversation = resolveToolConversation(ownership.read.conversationId, request.params?.arguments, extra);
+    const downstreamRequest = cloneRequestWithoutOwnedAnalyticsArguments(request, ownership.strip);
     const startTime = new Date();
     const preparedEvent = await prepareToolCallEvent(server, data, request, downstreamRequest, extra, startTime, conversation, ownership, resolvedEventType, canCaptureContextIntent);
     if (preparedEvent && explicitContextIntent) (0, external_intent_js_namespaceObject.setExplicitContextIntent)(preparedEvent.event, explicitContextIntent);
@@ -86,15 +86,39 @@ async function captureToolCall(params) {
     publishSuccessfulToolEvent(server, preparedEvent, finalResult, startTime, data.logger, takeCapturedError, result);
     return finalResult;
 }
+function resolveToolConversation(enabled, args, extra) {
+    const conversation = (0, external_conversation_id_js_namespaceObject.resolveConversationId)(enabled, args);
+    if (!conversation.minted) return conversation;
+    const carriedSession = extra?.sessionId || (0, external_session_token_js_namespaceObject.decodeSessionId)((0, external_session_token_js_namespaceObject.readMcpSessionHeader)((0, external_request_headers_js_namespaceObject.getRequestHeaders)(extra)));
+    return carriedSession ? {
+        minted: false,
+        conversationId: void 0
+    } : conversation;
+}
 function getActiveAnalyticsParameterOwnership(data, toolName, override, isVirtualAnalyticsTool) {
     const listed = toolName ? data.toolAnalyticsParameterOwnership.get(toolName) : void 0;
     const ownership = override ?? listed;
+    const enabled = {
+        context: !isVirtualAnalyticsTool && (0, external_context_parameters_js_namespaceObject.isContextEnabled)(data.options.context),
+        conversationId: true === data.options.enableConversationId,
+        llmModel: (0, external_model_parameters_js_namespaceObject.isCaptureModelEnabled)(data.options.captureModel)
+    };
+    return {
+        strip: enabledArgumentOwnership(enabled, ownership, false),
+        read: enabledArgumentOwnership(enabled, ownership, true),
+        outputInstructions: enabled.conversationId && listed?.outputInstructions === true
+    };
+}
+function enabledArgumentOwnership(enabled, ownership, whenUnknown) {
+    const resolved = ownership ?? {
+        context: whenUnknown,
+        conversationId: whenUnknown,
+        llmModel: whenUnknown
+    };
     return {
-        contextOwnershipKnown: void 0 !== ownership,
-        context: !isVirtualAnalyticsTool && (0, external_context_parameters_js_namespaceObject.isContextEnabled)(data.options.context) && ownership?.context === true,
-        conversationId: true === data.options.enableConversationId && ownership?.conversationId === true,
-        llmModel: (0, external_model_parameters_js_namespaceObject.isCaptureModelEnabled)(data.options.captureModel) && ownership?.llmModel === true,
-        outputInstructions: true === data.options.enableConversationId && listed?.outputInstructions === true
+        context: enabled.context && resolved.context,
+        conversationId: enabled.conversationId && resolved.conversationId,
+        llmModel: enabled.llmModel && resolved.llmModel
     };
 }
 function cloneRequestWithoutOwnedAnalyticsArguments(request, ownership) {
@@ -131,7 +155,7 @@ async function prepareToolCallEvent(server, data, request, downstreamRequest, ex
         await (0, external_tracing_helpers_js_namespaceObject.applyResolvedMetadata)(event, data, request, extra);
         (0, external_intent_js_namespaceObject.setEventIntent)(event, await (0, external_intent_js_namespaceObject.resolveToolCallIntent)(data, request, canCaptureContextIntent, extra));
         if ((0, external_model_parameters_js_namespaceObject.isCaptureModelEnabled)(data.options.captureModel)) {
-            const resolvedModel = (0, external_model_parameters_js_namespaceObject.resolveModel)(request, ownership.llmModel);
+            const resolvedModel = (0, external_model_parameters_js_namespaceObject.resolveModel)(request, ownership.read.llmModel);
             (0, external_model_parameters_js_namespaceObject.setEventModel)(event, resolvedModel?.model, resolvedModel?.source);
         }
         return {

package/dist/extensions/instrumentation.mjs

@@ -14,7 +14,7 @@ import { buildCapturedMcpParameters } from "./mcp-payloads.mjs";
 import { readRequestHandlerMethod } from "./mcp-sdk-compat.mjs";
 import { getRequestHeaders } from "./request-headers.mjs";
 import { getSessionId, getSessionInfo, isModernEraRequest, newSessionId } from "./session.mjs";
-import { encodeSessionId, readMcpSessionHeader, writeSessionIdToTransport } from "./session-token.mjs";
+import { decodeSessionId, encodeSessionId, readMcpSessionHeader, writeSessionIdToTransport } from "./session-token.mjs";
 import { SEND_FEEDBACK_TOOL_NAME, getFeedbackToolDescriptor, resolveCollectFeedbackOptions } from "./feedback.mjs";
 import { getReportMissingToolDescriptor, resolveMissingCapabilityToolName } from "./tools.mjs";
 import { applyResolvedMetadata, isToolResultError } from "./tracing-helpers.mjs";
@@ -23,9 +23,9 @@ async function captureToolCall(params) {
     const resolvedEventType = eventType ?? MCPAnalyticsEventType.mcpToolsCall;
     const isVirtualAnalyticsTool = resolvedEventType === MCPAnalyticsEventType.mcpMissingCapability || resolvedEventType === MCPAnalyticsEventType.mcpFeedback;
     const ownership = getActiveAnalyticsParameterOwnership(data, request.params?.name, parameterOwnership, isVirtualAnalyticsTool);
-    const canCaptureContextIntent = !isVirtualAnalyticsTool && isContextEnabled(data.options.context) && (ownership.context || !ownership.contextOwnershipKnown);
-    const conversation = resolveConversationId(ownership.conversationId, request.params?.arguments);
-    const downstreamRequest = cloneRequestWithoutOwnedAnalyticsArguments(request, ownership);
+    const canCaptureContextIntent = ownership.read.context;
+    const conversation = resolveToolConversation(ownership.read.conversationId, request.params?.arguments, extra);
+    const downstreamRequest = cloneRequestWithoutOwnedAnalyticsArguments(request, ownership.strip);
     const startTime = new Date();
     const preparedEvent = await prepareToolCallEvent(server, data, request, downstreamRequest, extra, startTime, conversation, ownership, resolvedEventType, canCaptureContextIntent);
     if (preparedEvent && explicitContextIntent) setExplicitContextIntent(preparedEvent.event, explicitContextIntent);
@@ -45,15 +45,39 @@ async function captureToolCall(params) {
     publishSuccessfulToolEvent(server, preparedEvent, finalResult, startTime, data.logger, takeCapturedError, result);
     return finalResult;
 }
+function resolveToolConversation(enabled, args, extra) {
+    const conversation = resolveConversationId(enabled, args);
+    if (!conversation.minted) return conversation;
+    const carriedSession = extra?.sessionId || decodeSessionId(readMcpSessionHeader(getRequestHeaders(extra)));
+    return carriedSession ? {
+        minted: false,
+        conversationId: void 0
+    } : conversation;
+}
 function getActiveAnalyticsParameterOwnership(data, toolName, override, isVirtualAnalyticsTool) {
     const listed = toolName ? data.toolAnalyticsParameterOwnership.get(toolName) : void 0;
     const ownership = override ?? listed;
+    const enabled = {
+        context: !isVirtualAnalyticsTool && isContextEnabled(data.options.context),
+        conversationId: true === data.options.enableConversationId,
+        llmModel: isCaptureModelEnabled(data.options.captureModel)
+    };
+    return {
+        strip: enabledArgumentOwnership(enabled, ownership, false),
+        read: enabledArgumentOwnership(enabled, ownership, true),
+        outputInstructions: enabled.conversationId && listed?.outputInstructions === true
+    };
+}
+function enabledArgumentOwnership(enabled, ownership, whenUnknown) {
+    const resolved = ownership ?? {
+        context: whenUnknown,
+        conversationId: whenUnknown,
+        llmModel: whenUnknown
+    };
     return {
-        contextOwnershipKnown: void 0 !== ownership,
-        context: !isVirtualAnalyticsTool && isContextEnabled(data.options.context) && ownership?.context === true,
-        conversationId: true === data.options.enableConversationId && ownership?.conversationId === true,
-        llmModel: isCaptureModelEnabled(data.options.captureModel) && ownership?.llmModel === true,
-        outputInstructions: true === data.options.enableConversationId && listed?.outputInstructions === true
+        context: enabled.context && resolved.context,
+        conversationId: enabled.conversationId && resolved.conversationId,
+        llmModel: enabled.llmModel && resolved.llmModel
     };
 }
 function cloneRequestWithoutOwnedAnalyticsArguments(request, ownership) {
@@ -90,7 +114,7 @@ async function prepareToolCallEvent(server, data, request, downstreamRequest, ex
         await applyResolvedMetadata(event, data, request, extra);
         setEventIntent(event, await resolveToolCallIntent(data, request, canCaptureContextIntent, extra));
         if (isCaptureModelEnabled(data.options.captureModel)) {
-            const resolvedModel = resolveModel(request, ownership.llmModel);
+            const resolvedModel = resolveModel(request, ownership.read.llmModel);
             setEventModel(event, resolvedModel?.model, resolvedModel?.source);
         }
         return {

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

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

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

@@ -24,7 +24,7 @@ export interface ModelInjectableTool {
     name?: string;
     [key: string]: unknown;
 }
-/** Unlike `context`, model capture is opt-in: off unless explicitly enabled. */
+/** Model capture is enabled unless explicitly disabled. */
 export declare function isCaptureModelEnabled(captureModel: MCPAnalyticsOptions['captureModel']): boolean;
 export declare function getModelDescription(captureModel: MCPAnalyticsOptions['captureModel']): string | undefined;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"model-parameters.d.ts","sourceRoot":"","sources":["../../src/extensions/model-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACtG,OAAO,EAA+B,KAAK,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AAExG,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,6BAA6B,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,OAAO,CAEhG;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,MAAM,GAAG,SAAS,CAEzG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,mBAAmB,EACvE,IAAI,EAAE,KAAK,EACX,wBAAwB,CAAC,EAAE,MAAM,EACjC,MAAM,GAAE,QAAc,GACrB,KAAK,CAQP;AAED,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,mBAAmB,EACxE,KAAK,EAAE,KAAK,EAAE,EACd,wBAAwB,CAAC,EAAE,MAAM,EACjC,MAAM,GAAE,QAAc,GACrB,KAAK,EAAE,CAET;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,uBAAuB,CAAA;CAChC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAiB3G;AAiBD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,GAAE,uBAAyC,GAChD,IAAI,CAON"}
+{"version":3,"file":"model-parameters.d.ts","sourceRoot":"","sources":["../../src/extensions/model-parameters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACtG,OAAO,EAA+B,KAAK,6BAA6B,EAAE,MAAM,wBAAwB,CAAA;AAExG,OAAO,EAAO,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAA;AAE7C;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,6BAA6B,CAAA;IAC3C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,2DAA2D;AAC3D,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,OAAO,CAIhG;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,MAAM,GAAG,SAAS,CAEzG;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,mBAAmB,EACvE,IAAI,EAAE,KAAK,EACX,wBAAwB,CAAC,EAAE,MAAM,EACjC,MAAM,GAAE,QAAc,GACrB,KAAK,CAQP;AAED,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,mBAAmB,EACxE,KAAK,EAAE,KAAK,EAAE,EACd,wBAAwB,CAAC,EAAE,MAAM,EACjC,MAAM,GAAE,QAAc,GACrB,KAAK,EAAE,CAET;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAE5E;AAID,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,uBAAuB,CAAA;CAChC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAiB3G;AAiBD,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,MAAM,GAAE,uBAAyC,GAChD,IAAI,CAON"}

package/dist/extensions/model-parameters.js

@@ -40,7 +40,7 @@ const external_analytics_parameters_js_namespaceObject = require("./analytics-pa
 const external_constants_js_namespaceObject = require("./constants.js");
 const external_logger_js_namespaceObject = require("./logger.js");
 function isCaptureModelEnabled(captureModel) {
-    return true === captureModel || 'object' == typeof captureModel && null !== captureModel;
+    return void 0 === captureModel || true === captureModel || 'object' == typeof captureModel && null !== captureModel;
 }
 function getModelDescription(captureModel) {
     return 'object' == typeof captureModel && null !== captureModel ? captureModel.description : void 0;

package/dist/extensions/model-parameters.mjs

@@ -2,7 +2,7 @@ import { addAnalyticsParameterToTool } from "./analytics-parameters.mjs";
 import { DEFAULT_MODEL_PARAMETER_DESCRIPTION } from "./constants.mjs";
 import { log } from "./logger.mjs";
 function isCaptureModelEnabled(captureModel) {
-    return true === captureModel || 'object' == typeof captureModel && null !== captureModel;
+    return void 0 === captureModel || true === captureModel || 'object' == typeof captureModel && null !== captureModel;
 }
 function getModelDescription(captureModel) {
     return 'object' == typeof captureModel && null !== captureModel ? captureModel.description : void 0;