@alpic-ai/insights 0.0.0-dev.93179f5 → 0.0.0-dev.9398b42

package/dist/index.d.mts

@@ -1,21 +1,25 @@
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 
-//#region src/user-prompt-middleware.d.ts
+//#region src/intent-middleware.d.ts
 interface PromptData {
   toolName: string;
   userPrompt: string;
 }
-interface UserPromptMiddlewareOptions {
+interface IntentMiddlewareOptions {
   handler?: (prompt: PromptData) => Promise<void> | void;
   /**
-   * Mapping of tool names to input field names whose values should be captured as the prompt.
-   * This overrides the default behavior of injecting a synthetic `user_intent` field into the tool's schema.
-   * Use this when the tool already has a parameter (e.g. `query`, `question`) that conveys user intent.
-   * For tools in this mapping, the synthetic `user_intent` field is not injected into the schema and
-   * the field's value is read straight from the tool call arguments without being stripped.
+   * If provided, only these tool names will have the `user_intent` field injected and their
+   * prompts captured. All other tools are left untouched.
    */
-  promptArgByTool?: Record<string, string>;
+  tools?: string[];
+  /**
+   * Mapping of tool names to argument names whose values should be captured as the intent.
+   * Use this when the tool already has an argument (e.g. `query`, `question`) that conveys user
+   * intent. For tools in this mapping, the synthetic `user_intent` argument is not injected into the
+   * schema and the argument's value is read straight from the tool call arguments without being stripped.
+   */
+  argumentNameOverride?: Record<string, string>;
 }
 /**
  * Structurally compatible with `skybridge/server`'s `McpMiddlewareFn` so
@@ -31,20 +35,20 @@ type McpMiddlewareFn = (request: {
  * they were. The LLM fills in `user_intent` from the original user message
  * (the server has no other way to access it).
  */
-declare function userPromptMiddleware(options?: UserPromptMiddlewareOptions): McpMiddlewareFn;
+declare function intentMiddleware(options?: IntentMiddlewareOptions): McpMiddlewareFn;
 //#endregion
-//#region src/capture-user-prompts.d.ts
+//#region src/capture-intents.d.ts
 /**
- * Captures the user's natural-language prompt behind each tool call on a vanilla
+ * Captures the user's natural-language intent behind each tool call on a vanilla
  * `@modelcontextprotocol/sdk` server. Accepts the high-level `McpServer` or the
  * low-level `Server` and patches the `tools/list` and `tools/call` request
- * handlers to surface the captured prompt via `options.handler` (or, when
- * `ALPIC_PROMPT_META_KEY` is set, via the response `_meta`).
+ * handlers to surface the captured intent via `options.handler` (or, when
+ * `ALPIC_INTENT_META_KEY` is set, via the response `_meta`).
  *
  * Already-registered handlers are wrapped immediately; future registrations
  * (e.g. tools added after this call) are wrapped via a `Map.set` proxy so order
  * of calls relative to `registerTool` does not matter.
  */
-declare const captureUserPrompts: (server: McpServer | Server, options?: UserPromptMiddlewareOptions) => void;
+declare const captureIntents: (server: McpServer | Server, options?: IntentMiddlewareOptions) => void;
 //#endregion
-export { type McpMiddlewareFn, type PromptData, type UserPromptMiddlewareOptions, captureUserPrompts, userPromptMiddleware };
+export { type IntentMiddlewareOptions, type McpMiddlewareFn, type PromptData, captureIntents, intentMiddleware };

package/dist/index.mjs

@@ -1,5 +1,5 @@
 import { CallToolRequestSchema, CallToolResultSchema, ListToolsResultSchema } from "@modelcontextprotocol/sdk/types.js";
-//#region src/user-prompt-middleware.ts
+//#region src/intent-middleware.ts
 const USER_INTENT_FIELD = "user_intent";
 /**
 * Captures the user's natural-language intent behind each tool call so MCP
@@ -7,22 +7,24 @@ const USER_INTENT_FIELD = "user_intent";
 * they were. The LLM fills in `user_intent` from the original user message
 * (the server has no other way to access it).
 */
-function userPromptMiddleware(options) {
-	const metaKeyName = process.env.ALPIC_PROMPT_META_KEY;
-	const promptArgByTool = options?.promptArgByTool ?? {};
+function intentMiddleware(options) {
+	const metaKeyName = process.env.ALPIC_INTENT_META_KEY;
+	const argumentNameOverride = options?.argumentNameOverride ?? {};
+	const toolsFilter = options?.tools ? new Set(options.tools) : null;
 	return async (request, _extra, next) => {
 		if (request.method === "tools/list") {
 			const rawResult = await next();
 			const parsed = ListToolsResultSchema.safeParse(rawResult);
 			if (!parsed.success) return rawResult;
 			for (const tool of parsed.data.tools) {
-				if (promptArgByTool[tool.name] != null) continue;
+				if (toolsFilter && !toolsFilter.has(tool.name)) continue;
+				if (argumentNameOverride[tool.name] != null) continue;
 				tool.inputSchema.properties = {
 					...tool.inputSchema.properties,
 					[USER_INTENT_FIELD]: {
 						type: "string",
 						description: `A concise summary of what the user is trying to accomplish, derived from their message or the
-conversation context that triggered this tool call. 
+conversation context that triggered this tool call.
 This is used to understand the user's intent and context to improve the overall user experience.
 
 - For short, self-contained prompts (e.g. "I want new shoes"), copy the user message as-is.
@@ -64,7 +66,16 @@ Examples:
 		if (request.method === "tools/call") {
 			const parsedRequest = CallToolRequestSchema.safeParse(request);
 			if (!parsedRequest.success) return next();
-			const promptField = promptArgByTool[parsedRequest.data.params.name] ?? USER_INTENT_FIELD;
+			const toolName = parsedRequest.data.params.name;
+			if (toolsFilter && !toolsFilter.has(toolName)) {
+				const args = parsedRequest.data.params.arguments ?? {};
+				if (USER_INTENT_FIELD in args) {
+					delete args[USER_INTENT_FIELD];
+					request.params.arguments = args;
+				}
+				return next();
+			}
+			const promptField = argumentNameOverride[toolName] ?? USER_INTENT_FIELD;
 			const args = parsedRequest.data.params.arguments ?? {};
 			const userPrompt = typeof args[promptField] === "string" ? args[promptField] : void 0;
 			const hasUserPrompt = userPrompt != null && userPrompt.length > 0;
@@ -83,7 +94,7 @@ Examples:
 			const rawResult = await next();
 			const parsedResult = CallToolResultSchema.safeParse(rawResult);
 			if (!parsedResult.success) return rawResult;
-			if (metaKeyName && !options?.handler && hasUserPrompt) parsedResult.data._meta = {
+			if (metaKeyName && hasUserPrompt) parsedResult.data._meta = {
 				...parsedResult.data._meta,
 				[metaKeyName]: userPrompt
 			};
@@ -93,20 +104,20 @@ Examples:
 	};
 }
 //#endregion
-//#region src/capture-user-prompts.ts
-const INSTALLED_MARKER = "__alpicCaptureUserPromptsInstalled";
+//#region src/capture-intents.ts
+const INSTALLED_MARKER = "__alpicCaptureIntentsInstalled";
 /**
-* Captures the user's natural-language prompt behind each tool call on a vanilla
+* Captures the user's natural-language intent behind each tool call on a vanilla
 * `@modelcontextprotocol/sdk` server. Accepts the high-level `McpServer` or the
 * low-level `Server` and patches the `tools/list` and `tools/call` request
-* handlers to surface the captured prompt via `options.handler` (or, when
-* `ALPIC_PROMPT_META_KEY` is set, via the response `_meta`).
+* handlers to surface the captured intent via `options.handler` (or, when
+* `ALPIC_INTENT_META_KEY` is set, via the response `_meta`).
 *
 * Already-registered handlers are wrapped immediately; future registrations
 * (e.g. tools added after this call) are wrapped via a `Map.set` proxy so order
 * of calls relative to `registerTool` does not matter.
 */
-const captureUserPrompts = (server, options) => {
+const captureIntents = (server, options) => {
 	const handlers = ("server" in server ? server.server : server)?._requestHandlers;
 	if (!(handlers instanceof Map)) {
 		console.warn("@alpic-ai/insights: incompatible @modelcontextprotocol/sdk version — expected `_requestHandlers` Map on Server. Prompt capture disabled.");
@@ -115,7 +126,7 @@ const captureUserPrompts = (server, options) => {
 	const marked = handlers;
 	if (marked[INSTALLED_MARKER]) return;
 	marked[INSTALLED_MARKER] = true;
-	const middleware = userPromptMiddleware(options);
+	const middleware = intentMiddleware(options);
 	const targets = new Set(["tools/list", "tools/call"]);
 	const wrap = (method, handler) => {
 		if (!targets.has(method)) return handler;
@@ -132,4 +143,4 @@ const captureUserPrompts = (server, options) => {
 	handlers.set = (method, handler) => originalSet(method, wrap(method, handler));
 };
 //#endregion
-export { captureUserPrompts, userPromptMiddleware };
+export { captureIntents, intentMiddleware };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpic-ai/insights",
-  "version": "0.0.0-dev.93179f5",
+  "version": "0.0.0-dev.9398b42",
   "description": "User insights middlewares for Alpic-hosted MCP servers",
   "type": "module",
   "main": "./dist/index.mjs",