@posthog/mcp 0.3.0 → 0.4.1

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

@@ -14,7 +14,7 @@ export interface ConversationIdInjectableTool {
     [key: string]: unknown;
 }
 export declare function addConversationIdToTool<TTool extends ConversationIdInjectableTool>(tool: TTool): TTool;
-export declare function addConversationIdToTools<TTool extends ConversationIdInjectableTool>(tools: TTool[]): TTool[];
+export declare function addConversationIdToTools<TTool extends ConversationIdInjectableTool>(tools: TTool[], missingCapabilityToolName?: string): TTool[];
 export type ConversationIdResolution = {
     minted: false;
     conversationId: string | undefined;
@@ -28,7 +28,7 @@ export type ConversationIdResolution = {
  *   - agent supplied a value → use it
  *   - agent omitted → mint a UUID
  */
-export declare function resolveConversationId(enabled: boolean, args: unknown, toolName: string | undefined): ConversationIdResolution;
+export declare function resolveConversationId(enabled: boolean, args: unknown, toolName: string | undefined, missingCapabilityToolName?: string): ConversationIdResolution;
 /**
  * Predicate matching the same eligibility checks injectConversationIdPromptBack uses,
  * exposed so callers can pre-decide whether the prompt-back will actually land

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":"AASA,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAE3D,UAAU,UAAU;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,4BAA4B,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,CA2CtG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,4BAA4B,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAO5G;AAED,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;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,wBAAwB,CAS1B;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAS1E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUvE;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,SAAS;IAAE,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CAAE,EAC3E,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAe7B;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":"AASA,eAAO,MAAM,0BAA0B,oBAAoB,CAAA;AAE3D,UAAU,UAAU;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,wBAAgB,uBAAuB,CAAC,KAAK,SAAS,4BAA4B,EAAE,IAAI,EAAE,KAAK,GAAG,KAAK,CA2CtG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,4BAA4B,EACjF,KAAK,EAAE,KAAK,EAAE,EACd,yBAAyB,GAAE,MAA4B,GACtD,KAAK,EAAE,CAOT;AAED,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;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,yBAAyB,GAAE,MAA4B,GACtD,wBAAwB,CAS1B;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAS1E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAUvE;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,SAAS;IAAE,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAA;CAAE,EAC3E,OAAO,EAAE,QAAQ,GAAG,QAAQ,CAe7B;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"}

package/dist/extensions/conversation-id.js

@@ -69,14 +69,14 @@ function addConversationIdToTool(tool) {
     };
     return modifiedTool;
 }
-function addConversationIdToTools(tools) {
+function addConversationIdToTools(tools, missingCapabilityToolName = external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME) {
     return tools.map((tool)=>{
-        if (tool.name === external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME) return tool;
+        if (tool.name === missingCapabilityToolName) return tool;
         return addConversationIdToTool(tool);
     });
 }
-function resolveConversationId(enabled, args, toolName) {
-    if (!enabled || toolName === external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME) return {
+function resolveConversationId(enabled, args, toolName, missingCapabilityToolName = external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME) {
+    if (!enabled || toolName === missingCapabilityToolName) return {
         minted: false,
         conversationId: void 0
     };

package/dist/extensions/conversation-id.mjs

@@ -32,14 +32,14 @@ function addConversationIdToTool(tool) {
     };
     return modifiedTool;
 }
-function addConversationIdToTools(tools) {
+function addConversationIdToTools(tools, missingCapabilityToolName = GET_MORE_TOOLS_NAME) {
     return tools.map((tool)=>{
-        if (tool.name === GET_MORE_TOOLS_NAME) return tool;
+        if (tool.name === missingCapabilityToolName) return tool;
         return addConversationIdToTool(tool);
     });
 }
-function resolveConversationId(enabled, args, toolName) {
-    if (!enabled || toolName === GET_MORE_TOOLS_NAME) return {
+function resolveConversationId(enabled, args, toolName, missingCapabilityToolName = GET_MORE_TOOLS_NAME) {
+    if (!enabled || toolName === missingCapabilityToolName) return {
         minted: false,
         conversationId: void 0
     };

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,EAAiC,sBAAsB,EAAiC,MAAM,UAAU,CAAA;AAgRpH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAqB9E"}
+{"version":3,"file":"instrument-highlevel.d.ts","sourceRoot":"","sources":["../../src/extensions/instrument-highlevel.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAiC,sBAAsB,EAAiC,MAAM,UAAU,CAAA;AAmRpH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAqB9E"}

package/dist/extensions/instrument-highlevel.js

@@ -104,8 +104,9 @@ function setupListenerToRegisteredTools(server) {
         (0, external_logger_js_namespaceObject.log)(`Warning: Failed to setup listener for registered tools - ${error}`);
     }
 }
-function addTracingToToolCallbackInternal(tool, toolName, _server) {
+function addTracingToToolCallbackInternal(tool, toolName, server) {
     const originalCallback = (0, external_mcp_sdk_compat_js_namespaceObject.getToolFunction)(tool);
+    const missingToolName = (0, external_tools_js_namespaceObject.resolveMissingCapabilityToolName)((0, external_internal_js_namespaceObject.getServerTrackingData)(server.server)?.options);
     if (wrappedCallbacks.has(originalCallback)) {
         (0, external_logger_js_namespaceObject.log)(`Tool ${toolName} callback already wrapped, skipping re-wrap`);
         return tool;
@@ -131,7 +132,7 @@ function addTracingToToolCallbackInternal(tool, toolName, _server) {
             }
             return input;
         };
-        const cleanedArgs = toolName === external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME ? args : (0, external_conversation_id_js_namespaceObject.stripConversationId)(removeContextFromArgs(args));
+        const cleanedArgs = toolName === missingToolName ? args : (0, external_conversation_id_js_namespaceObject.stripConversationId)(removeContextFromArgs(args));
         try {
             if (void 0 === cleanedArgs) {
                 const handler = originalCallback;
@@ -177,7 +178,7 @@ async function handleWrappedToolsCall(originalHandler, server, request, extra) {
         (0, external_logger_js_namespaceObject.log)('Warning: PostHog MCP analytics is unable to find server tracking data. Please ensure you have called instrument(server, options) before using tool calls.');
         return await originalHandler(request, extra);
     }
-    if (request.params?.name === external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME) {
+    if (request.params?.name === (0, external_tools_js_namespaceObject.resolveMissingCapabilityToolName)(data.options)) {
         const context = (0, external_tracing_helpers_js_namespaceObject.getContextArgument)(request) || '';
         return await (0, external_instrumentation_js_namespaceObject.captureToolCall)({
             server,

package/dist/extensions/instrument-highlevel.mjs

@@ -3,7 +3,7 @@ import { MCPAnalyticsEventType } from "./event-types.mjs";
 import { getServerTrackingData } from "./internal.mjs";
 import { log } from "./logger.mjs";
 import { createWrappedTool, getLiteralValue, getObjectShape, getToolFunction, hasToolFunction } from "./mcp-sdk-compat.mjs";
-import { GET_MORE_TOOLS_NAME, handleReportMissing } from "./tools.mjs";
+import { handleReportMissing, resolveMissingCapabilityToolName } from "./tools.mjs";
 import { captureToolCall, instrumentInitializeHandler, instrumentToolsListHandler, readToolMetaCategory } from "./instrumentation.mjs";
 import { getContextArgument } from "./tracing-helpers.mjs";
 const wrappedCallbacks = new WeakMap();
@@ -76,8 +76,9 @@ function setupListenerToRegisteredTools(server) {
         log(`Warning: Failed to setup listener for registered tools - ${error}`);
     }
 }
-function addTracingToToolCallbackInternal(tool, toolName, _server) {
+function addTracingToToolCallbackInternal(tool, toolName, server) {
     const originalCallback = getToolFunction(tool);
+    const missingToolName = resolveMissingCapabilityToolName(getServerTrackingData(server.server)?.options);
     if (wrappedCallbacks.has(originalCallback)) {
         log(`Tool ${toolName} callback already wrapped, skipping re-wrap`);
         return tool;
@@ -103,7 +104,7 @@ function addTracingToToolCallbackInternal(tool, toolName, _server) {
             }
             return input;
         };
-        const cleanedArgs = toolName === GET_MORE_TOOLS_NAME ? args : stripConversationId(removeContextFromArgs(args));
+        const cleanedArgs = toolName === missingToolName ? args : stripConversationId(removeContextFromArgs(args));
         try {
             if (void 0 === cleanedArgs) {
                 const handler = originalCallback;
@@ -149,7 +150,7 @@ async function handleWrappedToolsCall(originalHandler, server, request, extra) {
         log('Warning: PostHog MCP analytics is unable to find server tracking data. Please ensure you have called instrument(server, options) before using tool calls.');
         return await originalHandler(request, extra);
     }
-    if (request.params?.name === GET_MORE_TOOLS_NAME) {
+    if (request.params?.name === resolveMissingCapabilityToolName(data.options)) {
         const context = getContextArgument(request) || '';
         return await captureToolCall({
             server,

package/dist/extensions/instrument-lowlevel.js

@@ -50,7 +50,7 @@ async function handleToolCallRequest(server, originalCallToolHandler, request, e
         (0, external_logger_js_namespaceObject.log)('Warning: PostHog MCP analytics is unable to find server tracking data. Please ensure you have called instrument(server, options) before using tool calls.');
         return await originalCallToolHandler?.(request, extra);
     }
-    if (request.params?.name === external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME) {
+    if (request.params?.name === (0, external_tools_js_namespaceObject.resolveMissingCapabilityToolName)(data.options)) {
         const context = (0, external_tracing_helpers_js_namespaceObject.getContextArgument)(request) || '';
         return await (0, external_instrumentation_js_namespaceObject.captureToolCall)({
             server,

package/dist/extensions/instrument-lowlevel.mjs

@@ -2,7 +2,7 @@ import { CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { MCPAnalyticsEventType } from "./event-types.mjs";
 import { getServerTrackingData } from "./internal.mjs";
 import { log } from "./logger.mjs";
-import { GET_MORE_TOOLS_NAME, handleReportMissing } from "./tools.mjs";
+import { handleReportMissing, resolveMissingCapabilityToolName } from "./tools.mjs";
 import { captureToolCall, instrumentInitializeHandler, instrumentToolsListHandler } from "./instrumentation.mjs";
 import { getContextArgument } from "./tracing-helpers.mjs";
 function instrumentLowLevelServer(server) {
@@ -22,7 +22,7 @@ async function handleToolCallRequest(server, originalCallToolHandler, request, e
         log('Warning: PostHog MCP analytics is unable to find server tracking data. Please ensure you have called instrument(server, options) before using tool calls.');
         return await originalCallToolHandler?.(request, extra);
     }
-    if (request.params?.name === GET_MORE_TOOLS_NAME) {
+    if (request.params?.name === resolveMissingCapabilityToolName(data.options)) {
         const context = getContextArgument(request) || '';
         return await captureToolCall({
             server,

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

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/extensions/instrumentation.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAY,MAAM,UAAU,CAAA;AAWxH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAoBrD;;;;GAIG;AACH,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;;;;OAIG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAA;IACjC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAA;CAClC;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAsCnF;AAwHD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAsBtE;AAsGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CASnH;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAUjH;AAID;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAiCvE"}
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../../src/extensions/instrumentation.ts"],"names":[],"mappings":"AAIA,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,oCAAoC,CAAA;AAC3C,OAAO,KAAK,EAAE,6BAA6B,EAAE,gBAAgB,EAAE,cAAc,EAAE,aAAa,EAAY,MAAM,UAAU,CAAA;AAWxH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AAoBrD;;;;GAIG;AACH,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;;;;OAIG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAA;IACjC;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAA;CAClC;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAuCnF;AAwHD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAsBtE;AAuGD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CASnH;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGtE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAUjH;AAID;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAiCvE"}

package/dist/extensions/instrumentation.js

@@ -46,7 +46,7 @@ const external_tools_js_namespaceObject = require("./tools.js");
 const external_tracing_helpers_js_namespaceObject = require("./tracing-helpers.js");
 async function captureToolCall(params) {
     const { server, data, request, extra, execute, eventType, explicitContextIntent, takeCapturedError } = params;
-    const conversation = (0, external_conversation_id_js_namespaceObject.resolveConversationId)(data.options.enableConversationId ?? false, request.params?.arguments, request.params?.name);
+    const conversation = (0, external_conversation_id_js_namespaceObject.resolveConversationId)(data.options.enableConversationId ?? false, request.params?.arguments, request.params?.name, (0, external_tools_js_namespaceObject.resolveMissingCapabilityToolName)(data.options));
     const downstreamRequest = conversation.conversationId ? (0, external_conversation_id_js_namespaceObject.cloneRequestWithoutConversationId)(request) : request;
     const startTime = new Date();
     const event = await prepareToolCallEvent(server, data, request, downstreamRequest, extra, startTime, conversation, eventType ?? external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpToolsCall);
@@ -180,10 +180,11 @@ async function getTracedToolsList(server, originalListToolsHandler, request, ext
         const originalResponse = await originalListToolsHandler(request, extra);
         let tools = originalResponse.tools || [];
         if (data && (0, external_context_parameters_js_namespaceObject.isContextEnabled)(data.options.context)) tools = (0, external_context_parameters_js_namespaceObject.addContextParameterToTools)(tools, (0, external_context_parameters_js_namespaceObject.getContextDescription)(data.options.context));
-        if (data?.options.enableConversationId) tools = (0, external_conversation_id_js_namespaceObject.addConversationIdToTools)(tools);
+        if (data?.options.enableConversationId) tools = (0, external_conversation_id_js_namespaceObject.addConversationIdToTools)(tools, (0, external_tools_js_namespaceObject.resolveMissingCapabilityToolName)(data.options));
         if (data?.options.reportMissing) {
-            const alreadyPresent = tools.some((tool)=>tool?.name === external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME);
-            if (!alreadyPresent) tools.push((0, external_tools_js_namespaceObject.getReportMissingToolDescriptor)());
+            const missingToolName = (0, external_tools_js_namespaceObject.resolveMissingCapabilityToolName)(data.options);
+            const alreadyPresent = tools.some((tool)=>tool?.name === missingToolName);
+            if (!alreadyPresent) tools.push((0, external_tools_js_namespaceObject.getReportMissingToolDescriptor)(missingToolName));
         }
         if (data) {
             cacheToolDescriptions(data.toolDescriptions, tools);

package/dist/extensions/instrumentation.mjs

@@ -9,11 +9,11 @@ import { getServerTrackingData, handleIdentify } from "./internal.mjs";
 import { log } from "./logger.mjs";
 import { buildCapturedMcpParameters } from "./mcp-payloads.mjs";
 import { getServerSessionId } from "./session.mjs";
-import { GET_MORE_TOOLS_NAME, getReportMissingToolDescriptor } from "./tools.mjs";
+import { getReportMissingToolDescriptor, resolveMissingCapabilityToolName } from "./tools.mjs";
 import { applyResolvedMetadata, isToolResultError } from "./tracing-helpers.mjs";
 async function captureToolCall(params) {
     const { server, data, request, extra, execute, eventType, explicitContextIntent, takeCapturedError } = params;
-    const conversation = resolveConversationId(data.options.enableConversationId ?? false, request.params?.arguments, request.params?.name);
+    const conversation = resolveConversationId(data.options.enableConversationId ?? false, request.params?.arguments, request.params?.name, resolveMissingCapabilityToolName(data.options));
     const downstreamRequest = conversation.conversationId ? cloneRequestWithoutConversationId(request) : request;
     const startTime = new Date();
     const event = await prepareToolCallEvent(server, data, request, downstreamRequest, extra, startTime, conversation, eventType ?? MCPAnalyticsEventType.mcpToolsCall);
@@ -147,10 +147,11 @@ async function getTracedToolsList(server, originalListToolsHandler, request, ext
         const originalResponse = await originalListToolsHandler(request, extra);
         let tools = originalResponse.tools || [];
         if (data && isContextEnabled(data.options.context)) tools = addContextParameterToTools(tools, getContextDescription(data.options.context));
-        if (data?.options.enableConversationId) tools = addConversationIdToTools(tools);
+        if (data?.options.enableConversationId) tools = addConversationIdToTools(tools, resolveMissingCapabilityToolName(data.options));
         if (data?.options.reportMissing) {
-            const alreadyPresent = tools.some((tool)=>tool?.name === GET_MORE_TOOLS_NAME);
-            if (!alreadyPresent) tools.push(getReportMissingToolDescriptor());
+            const missingToolName = resolveMissingCapabilityToolName(data.options);
+            const alreadyPresent = tools.some((tool)=>tool?.name === missingToolName);
+            if (!alreadyPresent) tools.push(getReportMissingToolDescriptor(missingToolName));
         }
         if (data) {
             cacheToolDescriptions(data.toolDescriptions, tools);

package/dist/extensions/posthog-mcp.d.ts

@@ -1,5 +1,19 @@
-import { PostHog } from 'posthog-node';
-import type { InitializeCaptureData, ToolCallCaptureData } from '../types';
+import { PostHog, type PostHogOptions } from 'posthog-node';
+import type { InitializeCaptureData, MissingCapabilityCaptureData, PreparedToolCall, PrepareToolListOptions, ToolCallCaptureData, ToolsListCaptureData } from '../types';
+import { type ContextInjectableTool } from './context-parameters';
+/**
+ * Options for {@link PostHogMCP}. A superset of `posthog-node`'s options, plus
+ * MCP-specific knobs.
+ */
+export interface PostHogMCPOptions extends PostHogOptions {
+    /**
+     * Name of the virtual "report a missing capability" tool injected by
+     * {@link PostHogMCP.prepareToolList} and detected by
+     * {@link PostHogMCP.prepareToolCall}. Set once here so injection and detection
+     * can't drift. Defaults to `get_more_tools`.
+     */
+    missingCapabilityToolName?: string;
+}
 /**
  * A `posthog-node` client with first-class MCP analytics. Use this when there is
  * no `Server`/`McpServer` to wrap (e.g. a custom HTTP or hono dispatcher): the
@@ -35,9 +49,73 @@ import type { InitializeCaptureData, ToolCallCaptureData } from '../types';
  */
 export declare class PostHogMCP extends PostHog {
     #private;
+    constructor(apiKey: string, options?: PostHogMCPOptions);
     /** Capture a tool invocation. Emits `$mcp_tool_call` (+ an `$exception` sibling on error). */
     captureToolCall(data: ToolCallCaptureData): void;
     /** Capture the connection handshake. Emits `$mcp_initialize`. */
     captureInitialize(data: InitializeCaptureData): void;
+    /**
+     * Capture a `tools/list` response. Emits `$mcp_tools_list` carrying the
+     * advertised tool names (`$mcp_listed_tool_names`), which powers
+     * "advertised but never called" analysis. Pass the names you're about to
+     * return — typically the result of {@link prepareToolList}.
+     */
+    captureToolsList(data: ToolsListCaptureData): void;
+    /**
+     * Decorate your `tools/list` response with PostHog's analytics affordances:
+     * injects the `context` argument into every tool (so agents state their intent,
+     * captured as `$mcp_intent`) and, when `reportMissing` is on, appends the
+     * `get_more_tools` virtual tool (rename it via the `missingCapabilityToolName`
+     * constructor option). Returns a new array; your tools are untouched.
+     *
+     * The appended `get_more_tools` descriptor carries only the base MCP tool fields
+     * (name, description, input schema) — not any framework-specific fields your
+     * `TTool` may add (e.g. a `handler`). It is meant to be detected via
+     * {@link prepareToolCall}'s `isMissingCapability`, not dispatched through a handler.
+     *
+     * Call this when there is no `Server` to wrap — it does for a custom dispatcher
+     * what `instrument()` does for a `Server`. Pair it with {@link prepareToolCall}
+     * on the inbound side.
+     *
+     * @example
+     * ```ts
+     * // building your tools/list response
+     * return { tools: posthog.prepareToolList(myTools, { reportMissing: true }) }
+     * ```
+     */
+    prepareToolList<TTool extends ContextInjectableTool>(tools: TTool[], options?: PrepareToolListOptions): TTool[];
+    /**
+     * Read an incoming `tools/call` before you dispatch it: pulls the agent's
+     * intent off the injected `context` argument, strips `context` from the
+     * arguments (so your handler and its schema validation never see it), and flags
+     * whether the call targeted the `get_more_tools` virtual tool.
+     *
+     * Pass the returned `intent` / `intentSource` to {@link captureToolCall}, and
+     * dispatch the returned `args` to your tool.
+     *
+     * This only extracts the explicit `context` argument (`intentSource:
+     * 'context_parameter'`); it does not infer intent. If you run your own
+     * inference, pass that string with `intentSource: 'inferred'` straight to
+     * {@link captureToolCall} (the `instrument()` path's `intentFallback`
+     * equivalent).
+     *
+     * @example
+     * ```ts
+     * const { intent, intentSource, args, isMissingCapability } = posthog.prepareToolCall(name, rawArgs)
+     * if (isMissingCapability) {
+     *   posthog.captureMissingCapability({ context: intent, ...identity })
+     *   return getMoreToolsResult()
+     * }
+     * const result = await runTool(name, args)
+     * posthog.captureToolCall({ toolName: name, intent, intentSource, ...identity })
+     * ```
+     */
+    prepareToolCall(name: string, args?: Record<string, unknown>): PreparedToolCall;
+    /**
+     * Capture a `get_more_tools` call as a missing-capability report. Emits
+     * `$mcp_missing_capability` with the agent's description as `$mcp_intent`. Reply
+     * to the agent with `getMoreToolsResult()`.
+     */
+    captureMissingCapability(data: MissingCapabilityCaptureData): void;
 }
 //# sourceMappingURL=posthog-mcp.d.ts.map

package/dist/extensions/posthog-mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"posthog-mcp.d.ts","sourceRoot":"","sources":["../../src/extensions/posthog-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,KAAK,EAAE,qBAAqB,EAA0C,mBAAmB,EAAE,MAAM,UAAU,CAAA;AAMlH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,UAAW,SAAQ,OAAO;;IAOrC,8FAA8F;IAC9F,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAehD,iEAAiE;IACjE,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI;CAoBrD"}
+{"version":3,"file":"posthog-mcp.d.ts","sourceRoot":"","sources":["../../src/extensions/posthog-mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAA;AAE3D,OAAO,KAAK,EACV,qBAAqB,EAIrB,4BAA4B,EAC5B,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAA;AACjB,OAAO,EAIL,KAAK,qBAAqB,EAC3B,MAAM,sBAAsB,CAAA;AAO7B;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;;;;OAKG;IACH,yBAAyB,CAAC,EAAE,MAAM,CAAA;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,UAAW,SAAQ,OAAO;;gBAWzB,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB;IAK3D,8FAA8F;IAC9F,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI;IAgBhD,iEAAiE;IACjE,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI;IAUpD;;;;;OAKG;IACH,gBAAgB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAalD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CAAC,KAAK,SAAS,qBAAqB,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,OAAO,GAAE,sBAA2B,GAAG,KAAK,EAAE;IAYnH;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,gBAAgB;IAW/E;;;;OAIG;IACH,wBAAwB,CAAC,IAAI,EAAE,4BAA4B,GAAG,IAAI;CAkBnE"}

package/dist/extensions/posthog-mcp.js

@@ -27,12 +27,19 @@ __webpack_require__.d(__webpack_exports__, {
     PostHogMCP: ()=>PostHogMCP
 });
 const external_posthog_node_namespaceObject = require("posthog-node");
+const external_context_parameters_js_namespaceObject = require("./context-parameters.js");
 const external_event_types_js_namespaceObject = require("./event-types.js");
 const external_exceptions_js_namespaceObject = require("./exceptions.js");
 const external_logger_js_namespaceObject = require("./logger.js");
 const external_sink_js_namespaceObject = require("./sink.js");
+const external_tools_js_namespaceObject = require("./tools.js");
 class PostHogMCP extends external_posthog_node_namespaceObject.PostHog {
     #sink;
+    #missingCapabilityToolName;
+    constructor(apiKey, options = {}){
+        super(apiKey, options), this.#sink = new external_sink_js_namespaceObject.McpEventSink(this);
+        this.#missingCapabilityToolName = options.missingCapabilityToolName ?? external_tools_js_namespaceObject.GET_MORE_TOOLS_NAME;
+    }
     captureToolCall(data) {
         const event = baseEvent(external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpToolsCall, data);
         event.resourceName = data.toolName;
@@ -42,6 +49,7 @@ class PostHogMCP extends external_posthog_node_namespaceObject.PostHog {
         event.response = data.response;
         event.duration = data.durationMs;
         event.isError = data.isError;
+        applyIntent(event, data.intent, data.intentSource);
         if (data.isError) event.error = (0, external_exceptions_js_namespaceObject.captureException)(data.error ?? `Tool ${data.toolName} returned an error`);
         this.#emit(event);
     }
@@ -54,14 +62,49 @@ class PostHogMCP extends external_posthog_node_namespaceObject.PostHog {
         event.duration = data.durationMs;
         this.#emit(event);
     }
+    captureToolsList(data) {
+        const event = baseEvent(external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpToolsList, data);
+        event.listedToolNames = data.toolNames;
+        event.parameters = data.parameters;
+        event.response = data.response;
+        event.duration = data.durationMs;
+        event.isError = data.isError;
+        if (data.isError) event.error = (0, external_exceptions_js_namespaceObject.captureException)(data.error ?? 'tools/list failed');
+        this.#emit(event);
+    }
+    prepareToolList(tools, options = {}) {
+        const contextOption = options.context ?? true;
+        let prepared = (0, external_context_parameters_js_namespaceObject.isContextEnabled)(contextOption) ? (0, external_context_parameters_js_namespaceObject.addContextParameterToTools)(tools, (0, external_context_parameters_js_namespaceObject.getContextDescription)(contextOption)) : [
+            ...tools
+        ];
+        if (options.reportMissing && !prepared.some((tool)=>tool?.name === this.#missingCapabilityToolName)) prepared = [
+            ...prepared,
+            (0, external_tools_js_namespaceObject.getReportMissingToolDescriptor)(this.#missingCapabilityToolName)
+        ];
+        return prepared;
+    }
+    prepareToolCall(name, args) {
+        const rawContext = args?.context;
+        const intent = 'string' == typeof rawContext && rawContext.trim() ? rawContext.trim() : void 0;
+        return {
+            intent,
+            intentSource: intent ? 'context_parameter' : void 0,
+            args: stripContext(args),
+            isMissingCapability: name === this.#missingCapabilityToolName
+        };
+    }
+    captureMissingCapability(data) {
+        const event = baseEvent(external_event_types_js_namespaceObject.MCPAnalyticsEventType.mcpMissingCapability, data);
+        event.resourceName = this.#missingCapabilityToolName;
+        event.parameters = data.parameters;
+        applyIntent(event, data.context, 'context_parameter');
+        this.#emit(event);
+    }
     #emit(event) {
         this.#sink.capture(event, {
             enableExceptionAutocapture: this.options.enableExceptionAutocapture ?? true
         }).catch((error)=>(0, external_logger_js_namespaceObject.log)(`Warning: PostHogMCP failed to capture event - ${error}`));
     }
-    constructor(...args){
-        super(...args), this.#sink = new external_sink_js_namespaceObject.McpEventSink(this);
-    }
 }
 function baseEvent(eventType, common) {
     const event = {
@@ -75,6 +118,17 @@ function baseEvent(eventType, common) {
     if (common.setProperties && Object.keys(common.setProperties).length > 0) event.identifyActorData = common.setProperties;
     return event;
 }
+function applyIntent(event, intent, source) {
+    const trimmed = 'string' == typeof intent ? intent.trim() : '';
+    if (!trimmed) return;
+    event.userIntent = trimmed;
+    event.userIntentSource = source ?? 'context_parameter';
+}
+function stripContext(args) {
+    if (!args || !('context' in args)) return args;
+    const { context: _context, ...rest } = args;
+    return rest;
+}
 exports.PostHogMCP = __webpack_exports__.PostHogMCP;
 for(var __webpack_i__ in __webpack_exports__)if (-1 === [
     "PostHogMCP"

package/dist/extensions/posthog-mcp.mjs

@@ -1,10 +1,17 @@
 import { PostHog } from "posthog-node";
+import { addContextParameterToTools, getContextDescription, isContextEnabled } from "./context-parameters.mjs";
 import { MCPAnalyticsEventType } from "./event-types.mjs";
 import { captureException } from "./exceptions.mjs";
 import { log } from "./logger.mjs";
 import { McpEventSink } from "./sink.mjs";
+import { GET_MORE_TOOLS_NAME, getReportMissingToolDescriptor } from "./tools.mjs";
 class PostHogMCP extends PostHog {
     #sink;
+    #missingCapabilityToolName;
+    constructor(apiKey, options = {}){
+        super(apiKey, options), this.#sink = new McpEventSink(this);
+        this.#missingCapabilityToolName = options.missingCapabilityToolName ?? GET_MORE_TOOLS_NAME;
+    }
     captureToolCall(data) {
         const event = baseEvent(MCPAnalyticsEventType.mcpToolsCall, data);
         event.resourceName = data.toolName;
@@ -14,6 +21,7 @@ class PostHogMCP extends PostHog {
         event.response = data.response;
         event.duration = data.durationMs;
         event.isError = data.isError;
+        applyIntent(event, data.intent, data.intentSource);
         if (data.isError) event.error = captureException(data.error ?? `Tool ${data.toolName} returned an error`);
         this.#emit(event);
     }
@@ -26,14 +34,49 @@ class PostHogMCP extends PostHog {
         event.duration = data.durationMs;
         this.#emit(event);
     }
+    captureToolsList(data) {
+        const event = baseEvent(MCPAnalyticsEventType.mcpToolsList, data);
+        event.listedToolNames = data.toolNames;
+        event.parameters = data.parameters;
+        event.response = data.response;
+        event.duration = data.durationMs;
+        event.isError = data.isError;
+        if (data.isError) event.error = captureException(data.error ?? 'tools/list failed');
+        this.#emit(event);
+    }
+    prepareToolList(tools, options = {}) {
+        const contextOption = options.context ?? true;
+        let prepared = isContextEnabled(contextOption) ? addContextParameterToTools(tools, getContextDescription(contextOption)) : [
+            ...tools
+        ];
+        if (options.reportMissing && !prepared.some((tool)=>tool?.name === this.#missingCapabilityToolName)) prepared = [
+            ...prepared,
+            getReportMissingToolDescriptor(this.#missingCapabilityToolName)
+        ];
+        return prepared;
+    }
+    prepareToolCall(name, args) {
+        const rawContext = args?.context;
+        const intent = 'string' == typeof rawContext && rawContext.trim() ? rawContext.trim() : void 0;
+        return {
+            intent,
+            intentSource: intent ? 'context_parameter' : void 0,
+            args: stripContext(args),
+            isMissingCapability: name === this.#missingCapabilityToolName
+        };
+    }
+    captureMissingCapability(data) {
+        const event = baseEvent(MCPAnalyticsEventType.mcpMissingCapability, data);
+        event.resourceName = this.#missingCapabilityToolName;
+        event.parameters = data.parameters;
+        applyIntent(event, data.context, 'context_parameter');
+        this.#emit(event);
+    }
     #emit(event) {
         this.#sink.capture(event, {
             enableExceptionAutocapture: this.options.enableExceptionAutocapture ?? true
         }).catch((error)=>log(`Warning: PostHogMCP failed to capture event - ${error}`));
     }
-    constructor(...args){
-        super(...args), this.#sink = new McpEventSink(this);
-    }
 }
 function baseEvent(eventType, common) {
     const event = {
@@ -47,4 +90,15 @@ function baseEvent(eventType, common) {
     if (common.setProperties && Object.keys(common.setProperties).length > 0) event.identifyActorData = common.setProperties;
     return event;
 }
+function applyIntent(event, intent, source) {
+    const trimmed = 'string' == typeof intent ? intent.trim() : '';
+    if (!trimmed) return;
+    event.userIntent = trimmed;
+    event.userIntentSource = source ?? 'context_parameter';
+}
+function stripContext(args) {
+    if (!args || !('context' in args)) return args;
+    const { context: _context, ...rest } = args;
+    return rest;
+}
 export { PostHogMCP };

package/dist/extensions/sanitization.d.ts

@@ -1,7 +1,9 @@
 import type { Event, McpEvent } from '../types';
 /**
  * Sanitizes an event by redacting non-text content blocks from responses
- * and large base64-encoded strings from parameters.
+ * and large base64-encoded strings from parameters, and applying the same
+ * string redaction (PostHog tokens, base64 blobs, sensitive keys) to the
+ * agent-supplied intent.
  *
  * This is a synchronous operation that returns a new object without mutating the original.
  * It should run after customer redaction in the event pipeline.

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

@@ -1 +1 @@
-{"version":3,"file":"sanitization.d.ts","sourceRoot":"","sources":["../../src/extensions/sanitization.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAS/C;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,KAAK,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAYrE"}
+{"version":3,"file":"sanitization.d.ts","sourceRoot":"","sources":["../../src/extensions/sanitization.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AAS/C;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,KAAK,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAmBrE"}

package/dist/extensions/sanitization.js

@@ -36,6 +36,7 @@ function sanitizeEvent(event) {
     };
     if (null != result.response) result.response = sanitizeResponse(result.response);
     if (null != result.parameters) result.parameters = sanitizeParameters(result.parameters);
+    if (null != result.userIntent) result.userIntent = (0, external_mcp_payloads_js_namespaceObject.sanitizeCapturedValue)(result.userIntent);
     return result;
 }
 function sanitizeResponse(response) {

package/dist/extensions/sanitization.mjs

@@ -8,6 +8,7 @@ function sanitizeEvent(event) {
     };
     if (null != result.response) result.response = sanitizeResponse(result.response);
     if (null != result.parameters) result.parameters = sanitizeParameters(result.parameters);
+    if (null != result.userIntent) result.userIntent = sanitizeCapturedValue(result.userIntent);
     return result;
 }
 function sanitizeResponse(response) {

package/dist/extensions/tools.d.ts

@@ -1,7 +1,22 @@
 import { type CallToolResult, type ListToolsResult } from '@modelcontextprotocol/sdk/types.js';
 export declare const GET_MORE_TOOLS_NAME: "get_more_tools";
+/**
+ * The configured name of the `get_more_tools` virtual tool, falling back to the
+ * default. Resolve through here everywhere (inject + detect) so a custom name
+ * can't drift between call sites.
+ */
+export declare function resolveMissingCapabilityToolName(options?: {
+    missingCapabilityToolName?: string;
+}): string;
 type ReportMissingToolDescriptor = ListToolsResult['tools'][number];
-export declare function getReportMissingToolDescriptor(): ReportMissingToolDescriptor;
+export declare function getReportMissingToolDescriptor(name?: string): ReportMissingToolDescriptor;
+/**
+ * The canned acknowledgement returned to the agent after it calls
+ * `get_more_tools`. Reply with this from your dispatcher so the agent knows the
+ * report was recorded (custom dispatcher path); the `instrument()` path returns
+ * it automatically.
+ */
+export declare function getMoreToolsResult(): CallToolResult;
 export declare function handleReportMissing(args: {
     context: string;
 }): CallToolResult;

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

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