@alpic-ai/insights 0.0.0-dev.ge43ff87 → 0.0.0-dev.gea8a89a

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/dist/index.d.mts +15 -29
  2. package/dist/index.mjs +8 -40
  3. package/package.json +1 -1
package/dist/index.d.mts CHANGED
@@ -37,6 +37,20 @@ type McpMiddlewareFn = (request: {
37
37
  */
38
38
  declare function intentMiddleware(options?: IntentMiddlewareOptions): McpMiddlewareFn;
39
39
  //#endregion
40
+ //#region src/capture-intents.d.ts
41
+ /**
42
+ * Captures the user's natural-language intent behind each tool call on a vanilla
43
+ * `@modelcontextprotocol/sdk` server. Accepts the high-level `McpServer` or the
44
+ * low-level `Server` and patches the `tools/list` and `tools/call` request
45
+ * handlers to surface the captured intent via `options.handler` (or, when
46
+ * `ALPIC_INTENT_META_KEY` is set, via the response `_meta`).
47
+ *
48
+ * Already-registered handlers are wrapped immediately; future registrations
49
+ * (e.g. tools added after this call) are wrapped via a `Map.set` proxy so order
50
+ * of calls relative to `registerTool` does not matter.
51
+ */
52
+ declare const captureIntents: (server: McpServer | Server, options?: IntentMiddlewareOptions) => void;
53
+ //#endregion
40
54
  //#region src/feedback-middleware.d.ts
41
55
  interface FeedbackData {
42
56
  content: string;
@@ -58,32 +72,4 @@ interface FeedbackMiddlewareOptions {
58
72
  */
59
73
  declare function feedbackMiddleware(options?: FeedbackMiddlewareOptions): McpMiddlewareFn;
60
74
  //#endregion
61
- //#region src/capture-feedback.d.ts
62
- /**
63
- * Injects a `send_feedback` tool into a vanilla `@modelcontextprotocol/sdk`
64
- * server and captures feedback submissions. Accepts the high-level `McpServer`
65
- * or the low-level `Server` and patches the `tools/list` and `tools/call`
66
- * request handlers to surface captured feedback via `options.handler` (or,
67
- * when `ALPIC_FEEDBACK_META_KEY` is set, via the response `_meta`).
68
- *
69
- * Already-registered handlers are wrapped immediately; future registrations
70
- * are wrapped via a `Map.set` proxy so order of calls relative to
71
- * `registerTool` does not matter.
72
- */
73
- declare const captureFeedback: (server: McpServer | Server, options?: FeedbackMiddlewareOptions) => void;
74
- //#endregion
75
- //#region src/capture-intents.d.ts
76
- /**
77
- * Captures the user's natural-language intent behind each tool call on a vanilla
78
- * `@modelcontextprotocol/sdk` server. Accepts the high-level `McpServer` or the
79
- * low-level `Server` and patches the `tools/list` and `tools/call` request
80
- * handlers to surface the captured intent via `options.handler` (or, when
81
- * `ALPIC_INTENT_META_KEY` is set, via the response `_meta`).
82
- *
83
- * Already-registered handlers are wrapped immediately; future registrations
84
- * (e.g. tools added after this call) are wrapped via a `Map.set` proxy so order
85
- * of calls relative to `registerTool` does not matter.
86
- */
87
- declare const captureIntents: (server: McpServer | Server, options?: IntentMiddlewareOptions) => void;
88
- //#endregion
89
- export { type FeedbackData, type FeedbackMiddlewareOptions, type IntentMiddlewareOptions, type McpMiddlewareFn, type PromptData, captureFeedback, captureIntents, feedbackMiddleware, intentMiddleware };
75
+ export { type FeedbackData, type FeedbackMiddlewareOptions, type IntentMiddlewareOptions, type McpMiddlewareFn, type PromptData, captureIntents, feedbackMiddleware, intentMiddleware };
package/dist/index.mjs CHANGED
@@ -35,6 +35,12 @@ function feedbackMiddleware(options) {
35
35
  }
36
36
  },
37
37
  required: ["content", "source"]
38
+ },
39
+ annotations: {
40
+ readOnlyHint: false,
41
+ destructiveHint: false,
42
+ openWorldHint: true,
43
+ idempotentHint: true
38
44
  }
39
45
  });
40
46
  return parsed.data;
@@ -56,6 +62,7 @@ function feedbackMiddleware(options) {
56
62
  content,
57
63
  source
58
64
  };
65
+ if (process.env.NODE_ENV !== "production") console.log("[insights] feedback received:", feedback);
59
66
  if (options?.handler) try {
60
67
  await options.handler(feedback);
61
68
  } catch (error) {
@@ -75,45 +82,6 @@ function feedbackMiddleware(options) {
75
82
  };
76
83
  }
77
84
  //#endregion
78
- //#region src/capture-feedback.ts
79
- const INSTALLED_MARKER$1 = "__alpicCaptureFeedbackInstalled";
80
- /**
81
- * Injects a `send_feedback` tool into a vanilla `@modelcontextprotocol/sdk`
82
- * server and captures feedback submissions. Accepts the high-level `McpServer`
83
- * or the low-level `Server` and patches the `tools/list` and `tools/call`
84
- * request handlers to surface captured feedback via `options.handler` (or,
85
- * when `ALPIC_FEEDBACK_META_KEY` is set, via the response `_meta`).
86
- *
87
- * Already-registered handlers are wrapped immediately; future registrations
88
- * are wrapped via a `Map.set` proxy so order of calls relative to
89
- * `registerTool` does not matter.
90
- */
91
- const captureFeedback = (server, options) => {
92
- const handlers = ("server" in server ? server.server : server)?._requestHandlers;
93
- if (!(handlers instanceof Map)) {
94
- console.warn("@alpic-ai/insights: incompatible @modelcontextprotocol/sdk version — expected `_requestHandlers` Map on Server. Feedback capture disabled.");
95
- return;
96
- }
97
- const marked = handlers;
98
- if (marked[INSTALLED_MARKER$1]) return;
99
- marked[INSTALLED_MARKER$1] = true;
100
- const middleware = feedbackMiddleware(options);
101
- const targets = new Set(["tools/list", "tools/call"]);
102
- const wrap = (method, handler) => {
103
- if (!targets.has(method)) return handler;
104
- return async (...args) => {
105
- const [request, extra] = args;
106
- return middleware({
107
- method,
108
- params: request.params ?? {}
109
- }, extra, () => handler(...args));
110
- };
111
- };
112
- for (const [method, handler] of [...handlers]) handlers.set(method, wrap(method, handler));
113
- const originalSet = handlers.set.bind(handlers);
114
- handlers.set = (method, handler) => originalSet(method, wrap(method, handler));
115
- };
116
- //#endregion
117
85
  //#region src/intent-middleware.ts
118
86
  const USER_INTENT_FIELD = "user_intent";
119
87
  /**
@@ -259,4 +227,4 @@ const captureIntents = (server, options) => {
259
227
  handlers.set = (method, handler) => originalSet(method, wrap(method, handler));
260
228
  };
261
229
  //#endregion
262
- export { captureFeedback, captureIntents, feedbackMiddleware, intentMiddleware };
230
+ export { captureIntents, feedbackMiddleware, intentMiddleware };
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@alpic-ai/insights",
3
- "version": "0.0.0-dev.ge43ff87",
3
+ "version": "0.0.0-dev.gea8a89a",
4
4
  "description": "User insights middlewares for Alpic-hosted MCP servers",
5
5
  "type": "module",
6
6
  "main": "./dist/index.mjs",