mcpfy-pulse 0.1.2 → 0.1.3

package/README.md

@@ -1,25 +1,62 @@
-# mcpfy-pulse
+<div align="center">
 
-Telemetry for MCP servers. Captures method names, payload sizes, durations, and outcomes
-for every JSON-RPC request an MCP server handles — never argument values, never resource
-content. See [`telemetry-master-plan.md`](../../../../telemetry-master-plan.md) for the
-full design.
+<pre>
+ ███╗   ███╗ ██████╗██████╗ ███████╗██╗   ██╗    ██████╗ ██╗   ██╗██╗     ███████╗███████╗
+ ████╗ ████║██╔════╝██╔══██╗██╔════╝╚██╗ ██╔╝    ██╔══██╗██║   ██║██║     ██╔════╝██╔════╝
+ ██╔████╔██║██║     ██████╔╝█████╗   ╚████╔╝     ██████╔╝██║   ██║██║     ███████╗█████╗
+ ██║╚██╔╝██║██║     ██╔═══╝ ██╔══╝    ╚██╔╝      ██╔═══╝ ██║   ██║██║     ╚════██║██╔══╝
+ ██║ ╚═╝ ██║╚██████╗██║     ██║        ██║       ██║     ╚██████╔╝███████╗███████║███████╗
+ ╚═╝     ╚═╝ ╚═════╝╚═╝     ╚═╝        ╚═╝       ╚═╝      ╚═════╝ ╚══════╝╚══════╝╚══════╝
+</pre>
 
-There are exactly three ways to use this. Pick the one that matches your situation — none
+📊 Tool-level telemetry | 🩺 Server health score | 🧠 Tool intelligence | 🎯 Result quality scoring | 🔌 Works with any MCP server
+
+A drop-in telemetry SDK that captures tool-level usage and performance to give you a real-time health signal for your MCP server - works with any MCP server.
+
+```bash
+npm install mcpfy-pulse
+```
+
+</div>
+
+There are exactly three ways to use this. Pick the one that matches your situation - none
 of them edit your files for you.
 
+Every mode needs an API key. Create one from your [MCPFY dashboard](https://mcpfy.ai/dashboard/telemetry)
+(**Dashboard → Telemetry**), then set it as `MCPFY_API_KEY` as shown below.
+
 ## 1. You're using `mcpfy-sdk`
 
-Nothing to install or import. Set one environment variable:
+No install step - `mcpfy-pulse` ships bundled with `mcpfy-sdk`. Just set one environment
+variable:
 
 ```bash
 MCPFY_API_KEY=mk_live_xxx node dist/server.js
 ```
 
 `mcpfy-sdk` checks for `MCPFY_API_KEY` internally and wraps its own transport
-automatically. Unset the variable and nothing changes — no code path is even touched.
+automatically. Unset the variable and nothing changes - no code path is even touched.
+
+## 2. You're not using `mcpfy-sdk` - you built your own server
+
+For anyone who wrote their own server on the raw `@modelcontextprotocol/sdk` (or
+anything else that exposes a `Transport`) and has the source in front of them. Three
+steps:
+
+**1. Install the package:**
+
+```bash
+npm install mcpfy-pulse
+```
+
+**2. Set your API key** (e.g. in your `.env` file):
+
+```bash
+MCPFY_API_KEY=mk_live_xxx
+```
 
-## 2. You have a raw `@modelcontextprotocol/sdk` server (source available)
+**3. Wrap your transport**, right before you connect it - this works for any transport
+(stdio, HTTP, SSE, ...), not just the stdio example below:
 
 ```ts
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -31,14 +68,16 @@ await server.connect(
 );
 ```
 
-`withMcpfyTelemetry` wraps the `Transport`'s `onmessage`/`send` seam — the two points
+`withMcpfyTelemetry` wraps the `Transport`'s `onmessage`/`send` seam - the two points
 every JSON-RPC message passes through regardless of which SDK built the server. If
-`apiKey` is unset, it returns the original transport unchanged.
+`apiKey` is unset, it returns the original transport unchanged, so it's safe to leave
+this in place across environments.
 
 ## 3. You're running someone else's server locally (no source access)
 
-Edit your MCP client's config (`claude_desktop_config.json`, Cursor's `mcp.json`, etc.)
-to route the command through the proxy:
+No install step - `npx` fetches `mcpfy-proxy` automatically the first time it runs. Edit
+your MCP client's config (`claude_desktop_config.json`, Cursor's `mcp.json`, etc.) to
+route the command through the proxy:
 
 ```jsonc
 // before:
@@ -54,35 +93,5 @@ to route the command through the proxy:
 
 `mcpfy-proxy` becomes the process your client spawns. It spawns the real command as its
 own child, sits in that child's stdin/stdout, and forwards every byte unchanged while
-classifying JSON-RPC messages on the side. Works for any language — Python, Go, Rust,
-anything — since it only ever reads newline-delimited JSON off a pipe.
-
-## What gets sent
-
-One event per completed request:
-
-```json
-{
-  "method": "tools/call",
-  "toolName": "create_pull_request",
-  "argsBytes": 312,
-  "resultBytes": 1024,
-  "durationMs": 1840,
-  "outcome": "ok",
-  "timestamp": "2026-08-06T10:23:15.000Z"
-}
-```
-
-Batched and POSTed every 5 seconds (or every 500 events, whichever comes first) to
-`MCPFY_TELEMETRY_ENDPOINT` (defaults to the MCPFY ingest URL). If the request fails —
-including "the endpoint doesn't exist yet," which is currently true, see the master
-plan §4/§7 — the batch is silently dropped. Telemetry never throws, never retries
-indefinitely, and never delays or blocks the actual MCP traffic it's observing.
-
-## Environment variables
-
-| Variable | Purpose |
-|---|---|
-| `MCPFY_API_KEY` | Required for any telemetry to be sent. Unset = no-op everywhere. |
-| `MCPFY_TELEMETRY_ENDPOINT` | Override the ingest URL (e.g. for local testing). |
-| `MCPFY_GATEWAY` | Set internally by MCP-backend for gateway-routed servers, which already log through `McpGatewayLogger` — `mcpfy-sdk` skips wrapping when this is set, to avoid double-counting. Not something you set yourself. |
+classifying JSON-RPC messages on the side. Works for any language - Python, Go, Rust,
+anything - since it only ever reads newline-delimited JSON off a pipe.

package/dist/bin/mcpfy-proxy.js

@@ -18,13 +18,56 @@ function resolveConfig(options) {
 
 // src/core/classify.ts
 function byteLength(value) {
-  if (value === void 0) return 0;
+  if (value === void 0 || value === null) return 0;
   try {
     return Buffer.byteLength(JSON.stringify(value));
   } catch {
     return 0;
   }
 }
+function extractDeclaredTools(tools) {
+  if (!Array.isArray(tools)) return void 0;
+  const declared = [];
+  for (const tool of tools) {
+    if (!tool || typeof tool.name !== "string") continue;
+    const description = typeof tool.description === "string" ? tool.description : "";
+    const properties = tool.inputSchema?.properties;
+    const paramNames = properties && typeof properties === "object" ? Object.keys(properties) : [];
+    const paramsWithDescriptionCount = paramNames.filter(
+      (p) => typeof properties[p]?.description === "string" && properties[p].description.trim().length > 0
+    ).length;
+    const annotations = tool.annotations && typeof tool.annotations === "object" ? tool.annotations : void 0;
+    declared.push({
+      name: tool.name,
+      hasDescription: description.trim().length > 0,
+      descriptionLength: description.length,
+      paramCount: paramNames.length,
+      paramsWithDescriptionCount,
+      hasOutputSchema: tool.outputSchema != null && typeof tool.outputSchema === "object",
+      readOnlyHint: typeof annotations?.readOnlyHint === "boolean" ? annotations.readOnlyHint : void 0,
+      destructiveHint: typeof annotations?.destructiveHint === "boolean" ? annotations.destructiveHint : void 0,
+      idempotentHint: typeof annotations?.idempotentHint === "boolean" ? annotations.idempotentHint : void 0,
+      openWorldHint: typeof annotations?.openWorldHint === "boolean" ? annotations.openWorldHint : void 0
+    });
+  }
+  return declared;
+}
+function extractCapabilities(capabilities) {
+  if (!capabilities || typeof capabilities !== "object") return void 0;
+  const caps = capabilities;
+  const out = [];
+  const GROUPS = ["sampling", "elicitation", "roots", "tasks", "logging", "prompts", "resources", "tools", "completions"];
+  for (const group of GROUPS) {
+    const value = caps[group];
+    if (value === void 0 || value === null) continue;
+    out.push(group);
+    if (typeof value === "object") {
+      if (value.listChanged === true) out.push(`${group}.listChanged`);
+      if (group === "resources" && value.subscribe === true) out.push(`${group}.subscribe`);
+    }
+  }
+  return out.length > 0 ? out : void 0;
+}
 function extractLabel(method, params) {
   switch (method) {
     case "tools/call":
@@ -33,36 +76,98 @@ function extractLabel(method, params) {
       return { promptName: params?.name };
     case "resources/read":
       return { resourceUri: params?.uri };
-    case "initialize":
-      return {
+    case "initialize": {
+      const label = {
         clientName: params?.clientInfo?.name,
         clientVersion: params?.clientInfo?.version,
         protocolVersion: params?.protocolVersion
       };
+      const clientCapabilities = extractCapabilities(params?.capabilities);
+      if (clientCapabilities) label.clientCapabilities = clientCapabilities;
+      return label;
+    }
     default:
       return {};
   }
 }
 var MessageClassifier = class {
   pending = /* @__PURE__ */ new Map();
+  pendingByToken = /* @__PURE__ */ new Map();
+  forgetPending(id, pending) {
+    this.pending.delete(id);
+    if (pending.progressToken !== void 0) this.pendingByToken.delete(pending.progressToken);
+  }
+  /**
+   * Returns an event only for the one incoming case that completes a request without
+   * ever seeing a response: a client cancelling its own still-pending request. Every
+   * other incoming message (ordinary requests, `notifications/initialized`, and any
+   * other notification) returns `undefined`, matching prior behavior exactly.
+   */
   onIncoming(message) {
-    if (!message || typeof message !== "object") return;
+    if (!message || typeof message !== "object") return void 0;
     const { id, method, params } = message;
-    if (id === void 0 || !method) return;
-    this.pending.set(id, {
+    if (id === void 0 && method === "notifications/cancelled") {
+      const requestId = params?.requestId;
+      if (requestId === void 0) return void 0;
+      const pending = this.pending.get(requestId);
+      if (!pending) return void 0;
+      this.forgetPending(requestId, pending);
+      return {
+        type: "request",
+        method: pending.method,
+        argsBytes: pending.argsBytes,
+        durationMs: Date.now() - pending.startedAt,
+        outcome: "cancelled",
+        progressUpdateCount: pending.progressCount,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        ...pending.extra
+      };
+    }
+    if (id === void 0 || !method) return void 0;
+    const progressToken = params?._meta?.progressToken;
+    const entry = {
       method,
       startedAt: Date.now(),
       argsBytes: byteLength(params),
-      extra: extractLabel(method, params)
-    });
+      extra: extractLabel(method, params),
+      progressCount: 0
+    };
+    if (typeof progressToken === "string" || typeof progressToken === "number") {
+      entry.progressToken = String(progressToken);
+      this.pendingByToken.set(entry.progressToken, id);
+    }
+    this.pending.set(id, entry);
+    return void 0;
   }
   onOutgoing(message) {
     if (!message || typeof message !== "object") return void 0;
-    const { id, method, result, error } = message;
+    const { id, method, params, result, error } = message;
+    if (method && id === void 0) {
+      if (method === "notifications/progress") {
+        const pendingId = this.pendingByToken.get(String(params?.progressToken));
+        if (pendingId !== void 0) {
+          const pending2 = this.pending.get(pendingId);
+          if (pending2) pending2.progressCount += 1;
+        }
+        return void 0;
+      }
+      if (method === "notifications/message") {
+        return {
+          type: "notification",
+          method,
+          logLevel: typeof params?.level === "string" ? params.level : void 0,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+      }
+      if (method === "notifications/tools/list_changed" || method === "notifications/resources/list_changed" || method === "notifications/prompts/list_changed") {
+        return { type: "notification", method, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+      }
+      return void 0;
+    }
     if (method || id === void 0) return void 0;
     const pending = this.pending.get(id);
     if (!pending) return void 0;
-    this.pending.delete(id);
+    this.forgetPending(id, pending);
     const event = {
       type: "request",
       method: pending.method,
@@ -71,16 +176,25 @@ var MessageClassifier = class {
       durationMs: Date.now() - pending.startedAt,
       outcome: error ? "error" : "ok",
       errorCode: error?.code,
+      progressUpdateCount: pending.progressCount,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       ...pending.extra
     };
-    if (pending.method === "initialize" && result?.serverInfo) {
-      event.serverName = result.serverInfo.name;
-      event.serverVersion = result.serverInfo.version;
+    if (pending.method === "initialize" && !error) {
+      if (result?.serverInfo) {
+        event.serverName = result.serverInfo.name;
+        event.serverVersion = result.serverInfo.version;
+      }
+      const serverCapabilities = extractCapabilities(result?.capabilities);
+      if (serverCapabilities) event.serverCapabilities = serverCapabilities;
     }
     if (pending.method === "tools/call" && !error && result?.isError === true) {
       event.resultIsError = true;
     }
+    if (pending.method === "tools/list" && !error) {
+      const declaredTools = extractDeclaredTools(result?.tools);
+      if (declaredTools) event.declaredTools = declaredTools;
+    }
     return event;
   }
 };
@@ -184,7 +298,9 @@ async function runProxy(argv) {
   });
   pipeLines(process.stdin, child.stdin, (line) => {
     const message = tryParse(line);
-    if (message) classifier.onIncoming(message);
+    if (!message) return;
+    const event = classifier.onIncoming(message);
+    if (event && batcher) batcher.push(event);
   });
   pipeLines(child.stdout, process.stdout, (line) => {
     const message = tryParse(line);

package/dist/bin/mcpfy-proxy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/proxy/run.ts","../../src/config.ts","../../src/core/classify.ts","../../src/core/batcher.ts","../../src/bin/mcpfy-proxy.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { resolveConfig } from \"../config.js\";\nimport { MessageClassifier } from \"../core/classify.js\";\nimport { TelemetryBatcher } from \"../core/batcher.js\";\n\nfunction tryParse(line: string): any {\n  const trimmed = line.trim();\n  if (!trimmed) return undefined;\n  try {\n    return JSON.parse(trimmed);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Forwards raw chunks to `dest` immediately and unchanged, then independently\n * re-buffers a copy into newline-delimited lines for classification. The pass-through\n * path never waits on parsing — a bug in classification can never corrupt or delay\n * the actual MCP traffic.\n */\nfunction pipeLines(source: NodeJS.ReadableStream, dest: NodeJS.WritableStream, onLine: (line: string) => void): void {\n  let buffer = \"\";\n  source.on(\"data\", (chunk: Buffer) => {\n    dest.write(chunk);\n    buffer += chunk.toString(\"utf8\");\n    let newlineIndex: number;\n    while ((newlineIndex = buffer.indexOf(\"\\n\")) !== -1) {\n      const line = buffer.slice(0, newlineIndex);\n      buffer = buffer.slice(newlineIndex + 1);\n      onLine(line);\n    }\n  });\n}\n\n/**\n * `mcpfy-proxy -- <command> [args...]`\n *\n * Spawns <command> as a child process and sits in its stdin/stdout pipe. Client-to-server\n * messages (parent stdin -> child stdin) are classified as \"incoming\"; server-to-client\n * messages (child stdout -> parent stdout) are classified as \"outgoing\", mirroring\n * onmessage/send in the in-process wrapper. Works for any language — the proxy never\n * parses anything beyond newline-delimited JSON-RPC framing.\n */\nexport async function runProxy(argv: string[]): Promise<void> {\n  const sepIndex = argv.indexOf(\"--\");\n  if (sepIndex === -1 || sepIndex === argv.length - 1) {\n    process.stderr.write(\n      \"Usage: mcpfy-proxy -- <command> [args...]\\n\" +\n        \"Example: mcpfy-proxy -- npx -y @modelcontextprotocol/server-github\\n\"\n    );\n    process.exitCode = 1;\n    return;\n  }\n\n  const [command, ...args] = argv.slice(sepIndex + 1);\n  const config = resolveConfig();\n  const classifier = new MessageClassifier();\n  const batcher = config.apiKey\n    ? new TelemetryBatcher(config, { sdkName: \"unknown\", installMode: \"stdio-proxy\" })\n    : undefined;\n\n  const child = spawn(command, args, {\n    stdio: [\"pipe\", \"pipe\", \"inherit\"],\n    env: process.env,\n  });\n\n  child.on(\"error\", (err) => {\n    process.stderr.write(`mcpfy-proxy: failed to start \"${command}\": ${err.message}\\n`);\n    process.exitCode = 1;\n  });\n\n  pipeLines(process.stdin, child.stdin!, (line) => {\n    const message = tryParse(line);\n    if (message) classifier.onIncoming(message);\n  });\n\n  pipeLines(child.stdout!, process.stdout, (line) => {\n    const message = tryParse(line);\n    if (!message) return;\n    const event = classifier.onOutgoing(message);\n    if (event && batcher) batcher.push(event);\n  });\n\n  process.on(\"SIGINT\", () => child.kill(\"SIGINT\"));\n  process.on(\"SIGTERM\", () => child.kill(\"SIGTERM\"));\n\n  await new Promise<void>((resolvePromise) => {\n    child.on(\"exit\", (code, signal) => {\n      void batcher?.close().finally(() => {\n        if (signal) {\n          process.kill(process.pid, signal);\n        } else {\n          process.exitCode = code ?? 0;\n        }\n        resolvePromise();\n      });\n    });\n  });\n}\n","import type { TelemetryOptions } from \"./types.js\";\n\n// Path matches the real route on cloudmcp-nest: POST /v1/telemetry/ingest.\nconst DEFAULT_ENDPOINT = \"https://api.mcpfy.ai/v1/telemetry/ingest\";\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_MAX_BATCH_SIZE = 500;\n\nexport interface ResolvedConfig {\n  apiKey: string | undefined;\n  endpoint: string;\n  flushIntervalMs: number;\n  maxBatchSize: number;\n}\n\nexport function resolveConfig(options?: TelemetryOptions): ResolvedConfig {\n  return {\n    apiKey: options?.apiKey ?? process.env.MCPFY_API_KEY,\n    endpoint: options?.endpoint ?? process.env.MCPFY_TELEMETRY_ENDPOINT ?? DEFAULT_ENDPOINT,\n    flushIntervalMs: options?.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,\n    maxBatchSize: options?.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE,\n  };\n}\n","import type { TelemetryEvent } from \"../types.js\";\n\ninterface PendingEntry {\n  method: string;\n  startedAt: number;\n  argsBytes: number;\n  extra: Partial<TelemetryEvent>;\n}\n\nfunction byteLength(value: unknown): number {\n  if (value === undefined) return 0;\n  try {\n    return Buffer.byteLength(JSON.stringify(value));\n  } catch {\n    return 0;\n  }\n}\n\nfunction extractLabel(method: string, params: any): Partial<TelemetryEvent> {\n  switch (method) {\n    case \"tools/call\":\n      return { toolName: params?.name };\n    case \"prompts/get\":\n      return { promptName: params?.name };\n    case \"resources/read\":\n      return { resourceUri: params?.uri };\n    case \"initialize\":\n      // Protocol handshake metadata, not user data — same fields the spec itself exchanges in the clear.\n      return {\n        clientName: params?.clientInfo?.name,\n        clientVersion: params?.clientInfo?.version,\n        protocolVersion: params?.protocolVersion,\n      };\n    default:\n      return {};\n  }\n}\n\n/**\n * Tracks request/response pairs across the two seams every Transport exposes\n * (onmessage = incoming, send = outgoing) and emits one event per completed\n * request. Only method names, byte counts, timing, and outcome are captured —\n * argument values and result content are never read beyond their byte length.\n *\n * Server-initiated requests/notifications (sampling, elicitation, logging,\n * progress) are intentionally not tracked yet — out of scope for this pass.\n */\nexport class MessageClassifier {\n  private pending = new Map<string | number, PendingEntry>();\n\n  onIncoming(message: any): void {\n    if (!message || typeof message !== \"object\") return;\n    const { id, method, params } = message;\n    if (id === undefined || !method) return; // only requests carry both an id and a method\n    this.pending.set(id, {\n      method,\n      startedAt: Date.now(),\n      argsBytes: byteLength(params),\n      extra: extractLabel(method, params),\n    });\n  }\n\n  onOutgoing(message: any): TelemetryEvent | undefined {\n    if (!message || typeof message !== \"object\") return undefined;\n    const { id, method, result, error } = message;\n    if (method || id === undefined) return undefined;\n\n    const pending = this.pending.get(id);\n    if (!pending) return undefined;\n    this.pending.delete(id);\n\n    const event: TelemetryEvent = {\n      type: \"request\",\n      method: pending.method,\n      argsBytes: pending.argsBytes,\n      resultBytes: byteLength(error ?? result),\n      durationMs: Date.now() - pending.startedAt,\n      outcome: error ? \"error\" : \"ok\",\n      errorCode: error?.code,\n      timestamp: new Date().toISOString(),\n      ...pending.extra,\n    };\n\n    if (pending.method === \"initialize\" && result?.serverInfo) {\n      event.serverName = result.serverInfo.name;\n      event.serverVersion = result.serverInfo.version;\n    }\n\n    if (pending.method === \"tools/call\" && !error && result?.isError === true) {\n      event.resultIsError = true;\n    }\n\n    return event;\n  }\n}\n","import type { TelemetryEvent, SdkName, InstallMode } from \"../types.js\";\nimport type { ResolvedConfig } from \"../config.js\";\n\nexport interface BatchMeta {\n  serverName?: string;\n  serverVersion?: string;\n  sdkName: SdkName;\n  sdkVersion?: string;\n  installMode: InstallMode;\n}\n\n/**\n * Ring-buffer batcher: queues events, flushes on a timer or when full, and never\n * throws or retries indefinitely — a failed or unreachable ingest endpoint is a\n * silent no-op, by design (telemetry must never affect the server's own behavior,\n * and the endpoint may not exist yet — see telemetry-master-plan.md §4/§7).\n */\nexport class TelemetryBatcher {\n  private queue: TelemetryEvent[] = [];\n  private timer: ReturnType<typeof setInterval>;\n\n  constructor(\n    private readonly config: ResolvedConfig,\n    private readonly meta: BatchMeta\n  ) {\n    this.timer = setInterval(() => void this.flush(), config.flushIntervalMs);\n    this.timer.unref?.(); // telemetry must never be the reason a process stays alive\n  }\n\n  push(event: TelemetryEvent): void {\n    this.queue.push(event);\n    if (this.queue.length >= this.config.maxBatchSize) void this.flush();\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n    const events = this.queue.splice(0, this.queue.length);\n    try {\n      const response = await fetch(this.config.endpoint, {\n        method: \"POST\",\n        headers: {\n          \"content-type\": \"application/json\",\n          authorization: `Bearer ${this.config.apiKey ?? \"\"}`,\n        },\n        body: JSON.stringify({\n          serverName: this.meta.serverName,\n          serverVersion: this.meta.serverVersion,\n          sdkName: this.meta.sdkName,\n          sdkVersion: this.meta.sdkVersion,\n          installMode: this.meta.installMode,\n          events,\n        }),\n      });\n      // Never throws on a non-2xx (silent drop is still the contract — see class doc),\n      // but a warning is the difference between \"found the bug in 30 seconds\" and\n      // \"found it three days later\": a 404/401/500 here means events are being\n      // discarded even though fetch() itself didn't throw.\n      if (!response.ok) {\n        console.warn(\n          `[mcpfy-pulse] telemetry flush failed: ${response.status} ${response.statusText} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n        );\n      }\n    } catch (err) {\n      console.warn(\n        `[mcpfy-pulse] telemetry flush failed: ${err instanceof Error ? err.message : String(err)} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n      );\n    }\n  }\n\n  async close(): Promise<void> {\n    clearInterval(this.timer);\n    await this.flush();\n  }\n}\n","#!/usr/bin/env node\nimport { runProxy } from \"../proxy/run.js\";\n\nrunProxy(process.argv.slice(2)).catch((err) => {\n  process.stderr.write(`mcpfy-proxy: ${err instanceof Error ? err.message : String(err)}\\n`);\n  process.exitCode = 1;\n});\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/proxy/run.ts","../../src/config.ts","../../src/core/classify.ts","../../src/core/batcher.ts","../../src/bin/mcpfy-proxy.ts"],"sourcesContent":["import { spawn } from \"node:child_process\";\nimport { resolveConfig } from \"../config.js\";\nimport { MessageClassifier } from \"../core/classify.js\";\nimport { TelemetryBatcher } from \"../core/batcher.js\";\n\nfunction tryParse(line: string): any {\n  const trimmed = line.trim();\n  if (!trimmed) return undefined;\n  try {\n    return JSON.parse(trimmed);\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Forwards raw chunks to `dest` immediately and unchanged, then independently\n * re-buffers a copy into newline-delimited lines for classification. The pass-through\n * path never waits on parsing — a bug in classification can never corrupt or delay\n * the actual MCP traffic.\n */\nfunction pipeLines(source: NodeJS.ReadableStream, dest: NodeJS.WritableStream, onLine: (line: string) => void): void {\n  let buffer = \"\";\n  source.on(\"data\", (chunk: Buffer) => {\n    dest.write(chunk);\n    buffer += chunk.toString(\"utf8\");\n    let newlineIndex: number;\n    while ((newlineIndex = buffer.indexOf(\"\\n\")) !== -1) {\n      const line = buffer.slice(0, newlineIndex);\n      buffer = buffer.slice(newlineIndex + 1);\n      onLine(line);\n    }\n  });\n}\n\n/**\n * `mcpfy-proxy -- <command> [args...]`\n *\n * Spawns <command> as a child process and sits in its stdin/stdout pipe. Client-to-server\n * messages (parent stdin -> child stdin) are classified as \"incoming\"; server-to-client\n * messages (child stdout -> parent stdout) are classified as \"outgoing\", mirroring\n * onmessage/send in the in-process wrapper. Works for any language — the proxy never\n * parses anything beyond newline-delimited JSON-RPC framing.\n */\nexport async function runProxy(argv: string[]): Promise<void> {\n  const sepIndex = argv.indexOf(\"--\");\n  if (sepIndex === -1 || sepIndex === argv.length - 1) {\n    process.stderr.write(\n      \"Usage: mcpfy-proxy -- <command> [args...]\\n\" +\n        \"Example: mcpfy-proxy -- npx -y @modelcontextprotocol/server-github\\n\"\n    );\n    process.exitCode = 1;\n    return;\n  }\n\n  const [command, ...args] = argv.slice(sepIndex + 1);\n  const config = resolveConfig();\n  const classifier = new MessageClassifier();\n  const batcher = config.apiKey\n    ? new TelemetryBatcher(config, { sdkName: \"unknown\", installMode: \"stdio-proxy\" })\n    : undefined;\n\n  const child = spawn(command, args, {\n    stdio: [\"pipe\", \"pipe\", \"inherit\"],\n    env: process.env,\n  });\n\n  child.on(\"error\", (err) => {\n    process.stderr.write(`mcpfy-proxy: failed to start \"${command}\": ${err.message}\\n`);\n    process.exitCode = 1;\n  });\n\n  pipeLines(process.stdin, child.stdin!, (line) => {\n    const message = tryParse(line);\n    if (!message) return;\n    const event = classifier.onIncoming(message);\n    if (event && batcher) batcher.push(event);\n  });\n\n  pipeLines(child.stdout!, process.stdout, (line) => {\n    const message = tryParse(line);\n    if (!message) return;\n    const event = classifier.onOutgoing(message);\n    if (event && batcher) batcher.push(event);\n  });\n\n  process.on(\"SIGINT\", () => child.kill(\"SIGINT\"));\n  process.on(\"SIGTERM\", () => child.kill(\"SIGTERM\"));\n\n  await new Promise<void>((resolvePromise) => {\n    child.on(\"exit\", (code, signal) => {\n      void batcher?.close().finally(() => {\n        if (signal) {\n          process.kill(process.pid, signal);\n        } else {\n          process.exitCode = code ?? 0;\n        }\n        resolvePromise();\n      });\n    });\n  });\n}\n","import type { TelemetryOptions } from \"./types.js\";\n\n// Path matches the real route on cloudmcp-nest: POST /v1/telemetry/ingest.\nconst DEFAULT_ENDPOINT = \"https://api.mcpfy.ai/v1/telemetry/ingest\";\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_MAX_BATCH_SIZE = 500;\n\nexport interface ResolvedConfig {\n  apiKey: string | undefined;\n  endpoint: string;\n  flushIntervalMs: number;\n  maxBatchSize: number;\n}\n\nexport function resolveConfig(options?: TelemetryOptions): ResolvedConfig {\n  return {\n    apiKey: options?.apiKey ?? process.env.MCPFY_API_KEY,\n    endpoint: options?.endpoint ?? process.env.MCPFY_TELEMETRY_ENDPOINT ?? DEFAULT_ENDPOINT,\n    flushIntervalMs: options?.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,\n    maxBatchSize: options?.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE,\n  };\n}\n","import type { DeclaredToolMeta, TelemetryEvent } from \"../types.js\";\n\ninterface PendingEntry {\n  method: string;\n  startedAt: number;\n  argsBytes: number;\n  extra: Partial<TelemetryEvent>;\n  progressToken?: string;\n  progressCount: number;\n}\n\nfunction byteLength(value: unknown): number {\n  // `undefined` (no `params` key at all) and `null` (an explicit `\"params\": null`)\n  // both mean \"no meaningful params\" — collapsed to the same 0 here so argsBytes\n  // doesn't swing on a client's JSON-serialization choice. Matches classify.py's\n  // `_byte_length`, which can't tell the two apart once parsed into a dict anyway.\n  if (value === undefined || value === null) return 0;\n  try {\n    return Buffer.byteLength(JSON.stringify(value));\n  } catch {\n    return 0;\n  }\n}\n\n/**\n * Reduces a `tools/list` response's `result.tools` array to non-content metadata —\n * whether/how-long each description is, and how many of its params are individually\n * documented, plus structured-output/annotation presence. Never reads the description\n * text or schema into the event itself.\n */\nfunction extractDeclaredTools(tools: unknown): DeclaredToolMeta[] | undefined {\n  if (!Array.isArray(tools)) return undefined;\n  const declared: DeclaredToolMeta[] = [];\n  for (const tool of tools) {\n    if (!tool || typeof tool.name !== \"string\") continue;\n    const description = typeof tool.description === \"string\" ? tool.description : \"\";\n    const properties = tool.inputSchema?.properties;\n    const paramNames = properties && typeof properties === \"object\" ? Object.keys(properties) : [];\n    const paramsWithDescriptionCount = paramNames.filter(\n      (p) => typeof properties[p]?.description === \"string\" && properties[p].description.trim().length > 0,\n    ).length;\n    const annotations = tool.annotations && typeof tool.annotations === \"object\" ? tool.annotations : undefined;\n    declared.push({\n      name: tool.name,\n      hasDescription: description.trim().length > 0,\n      descriptionLength: description.length,\n      paramCount: paramNames.length,\n      paramsWithDescriptionCount,\n      hasOutputSchema: tool.outputSchema != null && typeof tool.outputSchema === \"object\",\n      readOnlyHint: typeof annotations?.readOnlyHint === \"boolean\" ? annotations.readOnlyHint : undefined,\n      destructiveHint: typeof annotations?.destructiveHint === \"boolean\" ? annotations.destructiveHint : undefined,\n      idempotentHint: typeof annotations?.idempotentHint === \"boolean\" ? annotations.idempotentHint : undefined,\n      openWorldHint: typeof annotations?.openWorldHint === \"boolean\" ? annotations.openWorldHint : undefined,\n    });\n  }\n  return declared;\n}\n\n/**\n * Flattens a `ClientCapabilities`/`ServerCapabilities` object to a list of dotted\n * capability paths that are actually declared — group-presence for capabilities with\n * no meaningful sub-flags, `<group>.<subflag>` for the handful that have one worth\n * surfacing (resources/prompts/tools listChanged, resources.subscribe). `experimental`\n * is deliberately skipped (arbitrary custom capability names, out of scope).\n */\nfunction extractCapabilities(capabilities: unknown): string[] | undefined {\n  if (!capabilities || typeof capabilities !== \"object\") return undefined;\n  const caps = capabilities as Record<string, any>;\n  const out: string[] = [];\n  const GROUPS = [\"sampling\", \"elicitation\", \"roots\", \"tasks\", \"logging\", \"prompts\", \"resources\", \"tools\", \"completions\"];\n  for (const group of GROUPS) {\n    const value = caps[group];\n    if (value === undefined || value === null) continue;\n    out.push(group);\n    if (typeof value === \"object\") {\n      if (value.listChanged === true) out.push(`${group}.listChanged`);\n      if (group === \"resources\" && value.subscribe === true) out.push(`${group}.subscribe`);\n    }\n  }\n  return out.length > 0 ? out : undefined;\n}\n\nfunction extractLabel(method: string, params: any): Partial<TelemetryEvent> {\n  switch (method) {\n    case \"tools/call\":\n      return { toolName: params?.name };\n    case \"prompts/get\":\n      return { promptName: params?.name };\n    case \"resources/read\":\n      return { resourceUri: params?.uri };\n    case \"initialize\": {\n      // Protocol handshake metadata, not user data — same fields the spec itself exchanges in the clear.\n      const label: Partial<TelemetryEvent> = {\n        clientName: params?.clientInfo?.name,\n        clientVersion: params?.clientInfo?.version,\n        protocolVersion: params?.protocolVersion,\n      };\n      const clientCapabilities = extractCapabilities(params?.capabilities);\n      if (clientCapabilities) label.clientCapabilities = clientCapabilities;\n      return label;\n    }\n    default:\n      return {};\n  }\n}\n\n/**\n * Tracks request/response pairs across the two seams every Transport exposes\n * (onmessage = incoming, send = outgoing) and emits one event per completed\n * request. Only method names, byte counts, timing, and outcome are captured —\n * argument values and result content are never read beyond their byte length.\n * The one exception is `tools/list`, where per-tool description/param *presence\n * and length* are captured (never the description text or schema) — see\n * `extractDeclaredTools`.\n *\n * Also tracks a handful of notification types now: `notifications/cancelled` (turns\n * into a completed event with `outcome:\"cancelled\"`, since the original request never\n * gets a response), `notifications/progress` (counted per request, never the progress\n * values themselves), and `notifications/message` plus the three list_changed\n * notifications (emitted as standalone `type:\"notification\"` events). Everything else server-initiated\n * (sampling, elicitation, roots) is still intentionally not tracked — out of scope for\n * this pass.\n */\nexport class MessageClassifier {\n  private pending = new Map<string | number, PendingEntry>();\n  private pendingByToken = new Map<string, string | number>();\n\n  private forgetPending(id: string | number, pending: PendingEntry): void {\n    this.pending.delete(id);\n    if (pending.progressToken !== undefined) this.pendingByToken.delete(pending.progressToken);\n  }\n\n  /**\n   * Returns an event only for the one incoming case that completes a request without\n   * ever seeing a response: a client cancelling its own still-pending request. Every\n   * other incoming message (ordinary requests, `notifications/initialized`, and any\n   * other notification) returns `undefined`, matching prior behavior exactly.\n   */\n  onIncoming(message: any): TelemetryEvent | undefined {\n    if (!message || typeof message !== \"object\") return undefined;\n    const { id, method, params } = message;\n\n    if (id === undefined && method === \"notifications/cancelled\") {\n      // Never read params.reason — free-text, same \"never content\" boundary as everything else.\n      const requestId = params?.requestId;\n      if (requestId === undefined) return undefined;\n      const pending = this.pending.get(requestId);\n      if (!pending) return undefined;\n      this.forgetPending(requestId, pending);\n      return {\n        type: \"request\",\n        method: pending.method,\n        argsBytes: pending.argsBytes,\n        durationMs: Date.now() - pending.startedAt,\n        outcome: \"cancelled\",\n        progressUpdateCount: pending.progressCount,\n        timestamp: new Date().toISOString(),\n        ...pending.extra,\n      };\n    }\n\n    if (id === undefined || !method) return undefined; // only requests carry both an id and a method\n\n    const progressToken = params?._meta?.progressToken;\n    const entry: PendingEntry = {\n      method,\n      startedAt: Date.now(),\n      argsBytes: byteLength(params),\n      extra: extractLabel(method, params),\n      progressCount: 0,\n    };\n    if (typeof progressToken === \"string\" || typeof progressToken === \"number\") {\n      entry.progressToken = String(progressToken);\n      this.pendingByToken.set(entry.progressToken, id);\n    }\n    this.pending.set(id, entry);\n    return undefined;\n  }\n\n  onOutgoing(message: any): TelemetryEvent | undefined {\n    if (!message || typeof message !== \"object\") return undefined;\n    const { id, method, params, result, error } = message;\n\n    if (method && id === undefined) {\n      // An outgoing notification (server -> client) — not a response.\n      if (method === \"notifications/progress\") {\n        const pendingId = this.pendingByToken.get(String(params?.progressToken));\n        if (pendingId !== undefined) {\n          const pending = this.pending.get(pendingId);\n          if (pending) pending.progressCount += 1;\n        }\n        return undefined;\n      }\n      if (method === \"notifications/message\") {\n        return {\n          type: \"notification\",\n          method,\n          logLevel: typeof params?.level === \"string\" ? params.level : undefined,\n          timestamp: new Date().toISOString(),\n        };\n      }\n      if (\n        method === \"notifications/tools/list_changed\" ||\n        method === \"notifications/resources/list_changed\" ||\n        method === \"notifications/prompts/list_changed\"\n      ) {\n        return { type: \"notification\", method, timestamp: new Date().toISOString() };\n      }\n      return undefined; // other notifications / server-initiated requests — still out of scope\n    }\n\n    if (method || id === undefined) return undefined;\n\n    const pending = this.pending.get(id);\n    if (!pending) return undefined;\n    this.forgetPending(id, pending);\n\n    const event: TelemetryEvent = {\n      type: \"request\",\n      method: pending.method,\n      argsBytes: pending.argsBytes,\n      resultBytes: byteLength(error ?? result),\n      durationMs: Date.now() - pending.startedAt,\n      outcome: error ? \"error\" : \"ok\",\n      errorCode: error?.code,\n      progressUpdateCount: pending.progressCount,\n      timestamp: new Date().toISOString(),\n      ...pending.extra,\n    };\n\n    if (pending.method === \"initialize\" && !error) {\n      if (result?.serverInfo) {\n        event.serverName = result.serverInfo.name;\n        event.serverVersion = result.serverInfo.version;\n      }\n      const serverCapabilities = extractCapabilities(result?.capabilities);\n      if (serverCapabilities) event.serverCapabilities = serverCapabilities;\n    }\n\n    if (pending.method === \"tools/call\" && !error && result?.isError === true) {\n      event.resultIsError = true;\n    }\n\n    if (pending.method === \"tools/list\" && !error) {\n      const declaredTools = extractDeclaredTools(result?.tools);\n      if (declaredTools) event.declaredTools = declaredTools;\n    }\n\n    return event;\n  }\n}\n","import type { TelemetryEvent, SdkName, InstallMode } from \"../types.js\";\nimport type { ResolvedConfig } from \"../config.js\";\n\nexport interface BatchMeta {\n  serverName?: string;\n  serverVersion?: string;\n  sdkName: SdkName;\n  sdkVersion?: string;\n  installMode: InstallMode;\n}\n\n/**\n * Ring-buffer batcher: queues events, flushes on a timer or when full, and never\n * throws or retries indefinitely — a failed or unreachable ingest endpoint is a\n * silent no-op, by design (telemetry must never affect the server's own behavior,\n * and the endpoint may not exist yet — see telemetry-master-plan.md §4/§7).\n */\nexport class TelemetryBatcher {\n  private queue: TelemetryEvent[] = [];\n  private timer: ReturnType<typeof setInterval>;\n\n  constructor(\n    private readonly config: ResolvedConfig,\n    private readonly meta: BatchMeta\n  ) {\n    this.timer = setInterval(() => void this.flush(), config.flushIntervalMs);\n    this.timer.unref?.(); // telemetry must never be the reason a process stays alive\n  }\n\n  push(event: TelemetryEvent): void {\n    this.queue.push(event);\n    if (this.queue.length >= this.config.maxBatchSize) void this.flush();\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n    const events = this.queue.splice(0, this.queue.length);\n    try {\n      const response = await fetch(this.config.endpoint, {\n        method: \"POST\",\n        headers: {\n          \"content-type\": \"application/json\",\n          authorization: `Bearer ${this.config.apiKey ?? \"\"}`,\n        },\n        body: JSON.stringify({\n          serverName: this.meta.serverName,\n          serverVersion: this.meta.serverVersion,\n          sdkName: this.meta.sdkName,\n          sdkVersion: this.meta.sdkVersion,\n          installMode: this.meta.installMode,\n          events,\n        }),\n      });\n      // Never throws on a non-2xx (silent drop is still the contract — see class doc),\n      // but a warning is the difference between \"found the bug in 30 seconds\" and\n      // \"found it three days later\": a 404/401/500 here means events are being\n      // discarded even though fetch() itself didn't throw.\n      if (!response.ok) {\n        console.warn(\n          `[mcpfy-pulse] telemetry flush failed: ${response.status} ${response.statusText} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n        );\n      }\n    } catch (err) {\n      console.warn(\n        `[mcpfy-pulse] telemetry flush failed: ${err instanceof Error ? err.message : String(err)} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n      );\n    }\n  }\n\n  async close(): Promise<void> {\n    clearInterval(this.timer);\n    await this.flush();\n  }\n}\n","#!/usr/bin/env node\nimport { runProxy } from \"../proxy/run.js\";\n\nrunProxy(process.argv.slice(2)).catch((err) => {\n  process.stderr.write(`mcpfy-proxy: ${err instanceof Error ? err.message : String(err)}\\n`);\n  process.exitCode = 1;\n});\n"],"mappings":"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","names":["pending"]}

package/dist/src/core/classify.d.ts

@@ -4,13 +4,29 @@ import type { TelemetryEvent } from "../types.js";
  * (onmessage = incoming, send = outgoing) and emits one event per completed
  * request. Only method names, byte counts, timing, and outcome are captured —
  * argument values and result content are never read beyond their byte length.
+ * The one exception is `tools/list`, where per-tool description/param *presence
+ * and length* are captured (never the description text or schema) — see
+ * `extractDeclaredTools`.
  *
- * Server-initiated requests/notifications (sampling, elicitation, logging,
- * progress) are intentionally not tracked yet — out of scope for this pass.
+ * Also tracks a handful of notification types now: `notifications/cancelled` (turns
+ * into a completed event with `outcome:"cancelled"`, since the original request never
+ * gets a response), `notifications/progress` (counted per request, never the progress
+ * values themselves), and `notifications/message` plus the three list_changed
+ * notifications (emitted as standalone `type:"notification"` events). Everything else server-initiated
+ * (sampling, elicitation, roots) is still intentionally not tracked — out of scope for
+ * this pass.
  */
 export declare class MessageClassifier {
     private pending;
-    onIncoming(message: any): void;
+    private pendingByToken;
+    private forgetPending;
+    /**
+     * Returns an event only for the one incoming case that completes a request without
+     * ever seeing a response: a client cancelling its own still-pending request. Every
+     * other incoming message (ordinary requests, `notifications/initialized`, and any
+     * other notification) returns `undefined`, matching prior behavior exactly.
+     */
+    onIncoming(message: any): TelemetryEvent | undefined;
     onOutgoing(message: any): TelemetryEvent | undefined;
 }
 //# sourceMappingURL=classify.d.ts.map

package/dist/src/core/classify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/core/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAsClD;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAA4C;IAE3D,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI;IAY9B,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,cAAc,GAAG,SAAS;CAgCrD"}
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../../src/core/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,aAAa,CAAC;AA0GpE;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,cAAc,CAAsC;IAE5D,OAAO,CAAC,aAAa;IAKrB;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,cAAc,GAAG,SAAS;IAyCpD,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,cAAc,GAAG,SAAS;CAuErD"}

package/dist/src/index.cjs

@@ -39,13 +39,56 @@ function resolveConfig(options) {
 
 // src/core/classify.ts
 function byteLength(value) {
-  if (value === void 0) return 0;
+  if (value === void 0 || value === null) return 0;
   try {
     return Buffer.byteLength(JSON.stringify(value));
   } catch {
     return 0;
   }
 }
+function extractDeclaredTools(tools) {
+  if (!Array.isArray(tools)) return void 0;
+  const declared = [];
+  for (const tool of tools) {
+    if (!tool || typeof tool.name !== "string") continue;
+    const description = typeof tool.description === "string" ? tool.description : "";
+    const properties = tool.inputSchema?.properties;
+    const paramNames = properties && typeof properties === "object" ? Object.keys(properties) : [];
+    const paramsWithDescriptionCount = paramNames.filter(
+      (p) => typeof properties[p]?.description === "string" && properties[p].description.trim().length > 0
+    ).length;
+    const annotations = tool.annotations && typeof tool.annotations === "object" ? tool.annotations : void 0;
+    declared.push({
+      name: tool.name,
+      hasDescription: description.trim().length > 0,
+      descriptionLength: description.length,
+      paramCount: paramNames.length,
+      paramsWithDescriptionCount,
+      hasOutputSchema: tool.outputSchema != null && typeof tool.outputSchema === "object",
+      readOnlyHint: typeof annotations?.readOnlyHint === "boolean" ? annotations.readOnlyHint : void 0,
+      destructiveHint: typeof annotations?.destructiveHint === "boolean" ? annotations.destructiveHint : void 0,
+      idempotentHint: typeof annotations?.idempotentHint === "boolean" ? annotations.idempotentHint : void 0,
+      openWorldHint: typeof annotations?.openWorldHint === "boolean" ? annotations.openWorldHint : void 0
+    });
+  }
+  return declared;
+}
+function extractCapabilities(capabilities) {
+  if (!capabilities || typeof capabilities !== "object") return void 0;
+  const caps = capabilities;
+  const out = [];
+  const GROUPS = ["sampling", "elicitation", "roots", "tasks", "logging", "prompts", "resources", "tools", "completions"];
+  for (const group of GROUPS) {
+    const value = caps[group];
+    if (value === void 0 || value === null) continue;
+    out.push(group);
+    if (typeof value === "object") {
+      if (value.listChanged === true) out.push(`${group}.listChanged`);
+      if (group === "resources" && value.subscribe === true) out.push(`${group}.subscribe`);
+    }
+  }
+  return out.length > 0 ? out : void 0;
+}
 function extractLabel(method, params) {
   switch (method) {
     case "tools/call":
@@ -54,36 +97,98 @@ function extractLabel(method, params) {
       return { promptName: params?.name };
     case "resources/read":
       return { resourceUri: params?.uri };
-    case "initialize":
-      return {
+    case "initialize": {
+      const label = {
         clientName: params?.clientInfo?.name,
         clientVersion: params?.clientInfo?.version,
         protocolVersion: params?.protocolVersion
       };
+      const clientCapabilities = extractCapabilities(params?.capabilities);
+      if (clientCapabilities) label.clientCapabilities = clientCapabilities;
+      return label;
+    }
     default:
       return {};
   }
 }
 var MessageClassifier = class {
   pending = /* @__PURE__ */ new Map();
+  pendingByToken = /* @__PURE__ */ new Map();
+  forgetPending(id, pending) {
+    this.pending.delete(id);
+    if (pending.progressToken !== void 0) this.pendingByToken.delete(pending.progressToken);
+  }
+  /**
+   * Returns an event only for the one incoming case that completes a request without
+   * ever seeing a response: a client cancelling its own still-pending request. Every
+   * other incoming message (ordinary requests, `notifications/initialized`, and any
+   * other notification) returns `undefined`, matching prior behavior exactly.
+   */
   onIncoming(message) {
-    if (!message || typeof message !== "object") return;
+    if (!message || typeof message !== "object") return void 0;
     const { id, method, params } = message;
-    if (id === void 0 || !method) return;
-    this.pending.set(id, {
+    if (id === void 0 && method === "notifications/cancelled") {
+      const requestId = params?.requestId;
+      if (requestId === void 0) return void 0;
+      const pending = this.pending.get(requestId);
+      if (!pending) return void 0;
+      this.forgetPending(requestId, pending);
+      return {
+        type: "request",
+        method: pending.method,
+        argsBytes: pending.argsBytes,
+        durationMs: Date.now() - pending.startedAt,
+        outcome: "cancelled",
+        progressUpdateCount: pending.progressCount,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        ...pending.extra
+      };
+    }
+    if (id === void 0 || !method) return void 0;
+    const progressToken = params?._meta?.progressToken;
+    const entry = {
       method,
       startedAt: Date.now(),
       argsBytes: byteLength(params),
-      extra: extractLabel(method, params)
-    });
+      extra: extractLabel(method, params),
+      progressCount: 0
+    };
+    if (typeof progressToken === "string" || typeof progressToken === "number") {
+      entry.progressToken = String(progressToken);
+      this.pendingByToken.set(entry.progressToken, id);
+    }
+    this.pending.set(id, entry);
+    return void 0;
   }
   onOutgoing(message) {
     if (!message || typeof message !== "object") return void 0;
-    const { id, method, result, error } = message;
+    const { id, method, params, result, error } = message;
+    if (method && id === void 0) {
+      if (method === "notifications/progress") {
+        const pendingId = this.pendingByToken.get(String(params?.progressToken));
+        if (pendingId !== void 0) {
+          const pending2 = this.pending.get(pendingId);
+          if (pending2) pending2.progressCount += 1;
+        }
+        return void 0;
+      }
+      if (method === "notifications/message") {
+        return {
+          type: "notification",
+          method,
+          logLevel: typeof params?.level === "string" ? params.level : void 0,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+      }
+      if (method === "notifications/tools/list_changed" || method === "notifications/resources/list_changed" || method === "notifications/prompts/list_changed") {
+        return { type: "notification", method, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+      }
+      return void 0;
+    }
     if (method || id === void 0) return void 0;
     const pending = this.pending.get(id);
     if (!pending) return void 0;
-    this.pending.delete(id);
+    this.forgetPending(id, pending);
     const event = {
       type: "request",
       method: pending.method,
@@ -92,16 +197,25 @@ var MessageClassifier = class {
       durationMs: Date.now() - pending.startedAt,
       outcome: error ? "error" : "ok",
       errorCode: error?.code,
+      progressUpdateCount: pending.progressCount,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       ...pending.extra
     };
-    if (pending.method === "initialize" && result?.serverInfo) {
-      event.serverName = result.serverInfo.name;
-      event.serverVersion = result.serverInfo.version;
+    if (pending.method === "initialize" && !error) {
+      if (result?.serverInfo) {
+        event.serverName = result.serverInfo.name;
+        event.serverVersion = result.serverInfo.version;
+      }
+      const serverCapabilities = extractCapabilities(result?.capabilities);
+      if (serverCapabilities) event.serverCapabilities = serverCapabilities;
     }
     if (pending.method === "tools/call" && !error && result?.isError === true) {
       event.resultIsError = true;
     }
+    if (pending.method === "tools/list" && !error) {
+      const declaredTools = extractDeclaredTools(result?.tools);
+      if (declaredTools) event.declaredTools = declaredTools;
+    }
     return event;
   }
 };
@@ -201,7 +315,8 @@ function withMcpfyTelemetry(transport, options) {
     },
     set onmessage(handler) {
       transport.onmessage = (message, extra) => {
-        classifier.onIncoming(message);
+        const event = classifier.onIncoming(message);
+        if (event) batcher.push(event);
         handler?.(message, extra);
       };
     }

package/dist/src/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts","../../src/config.ts","../../src/core/classify.ts","../../src/core/batcher.ts","../../src/wrap-transport.ts"],"sourcesContent":["export { withMcpfyTelemetry } from \"./wrap-transport.js\";\nexport type { TelemetryOptions, TelemetryEvent, MinimalTransport, SdkName, InstallMode } from \"./types.js\";\n","import type { TelemetryOptions } from \"./types.js\";\n\n// Path matches the real route on cloudmcp-nest: POST /v1/telemetry/ingest.\nconst DEFAULT_ENDPOINT = \"https://api.mcpfy.ai/v1/telemetry/ingest\";\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_MAX_BATCH_SIZE = 500;\n\nexport interface ResolvedConfig {\n  apiKey: string | undefined;\n  endpoint: string;\n  flushIntervalMs: number;\n  maxBatchSize: number;\n}\n\nexport function resolveConfig(options?: TelemetryOptions): ResolvedConfig {\n  return {\n    apiKey: options?.apiKey ?? process.env.MCPFY_API_KEY,\n    endpoint: options?.endpoint ?? process.env.MCPFY_TELEMETRY_ENDPOINT ?? DEFAULT_ENDPOINT,\n    flushIntervalMs: options?.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,\n    maxBatchSize: options?.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE,\n  };\n}\n","import type { TelemetryEvent } from \"../types.js\";\n\ninterface PendingEntry {\n  method: string;\n  startedAt: number;\n  argsBytes: number;\n  extra: Partial<TelemetryEvent>;\n}\n\nfunction byteLength(value: unknown): number {\n  if (value === undefined) return 0;\n  try {\n    return Buffer.byteLength(JSON.stringify(value));\n  } catch {\n    return 0;\n  }\n}\n\nfunction extractLabel(method: string, params: any): Partial<TelemetryEvent> {\n  switch (method) {\n    case \"tools/call\":\n      return { toolName: params?.name };\n    case \"prompts/get\":\n      return { promptName: params?.name };\n    case \"resources/read\":\n      return { resourceUri: params?.uri };\n    case \"initialize\":\n      // Protocol handshake metadata, not user data — same fields the spec itself exchanges in the clear.\n      return {\n        clientName: params?.clientInfo?.name,\n        clientVersion: params?.clientInfo?.version,\n        protocolVersion: params?.protocolVersion,\n      };\n    default:\n      return {};\n  }\n}\n\n/**\n * Tracks request/response pairs across the two seams every Transport exposes\n * (onmessage = incoming, send = outgoing) and emits one event per completed\n * request. Only method names, byte counts, timing, and outcome are captured —\n * argument values and result content are never read beyond their byte length.\n *\n * Server-initiated requests/notifications (sampling, elicitation, logging,\n * progress) are intentionally not tracked yet — out of scope for this pass.\n */\nexport class MessageClassifier {\n  private pending = new Map<string | number, PendingEntry>();\n\n  onIncoming(message: any): void {\n    if (!message || typeof message !== \"object\") return;\n    const { id, method, params } = message;\n    if (id === undefined || !method) return; // only requests carry both an id and a method\n    this.pending.set(id, {\n      method,\n      startedAt: Date.now(),\n      argsBytes: byteLength(params),\n      extra: extractLabel(method, params),\n    });\n  }\n\n  onOutgoing(message: any): TelemetryEvent | undefined {\n    if (!message || typeof message !== \"object\") return undefined;\n    const { id, method, result, error } = message;\n    if (method || id === undefined) return undefined;\n\n    const pending = this.pending.get(id);\n    if (!pending) return undefined;\n    this.pending.delete(id);\n\n    const event: TelemetryEvent = {\n      type: \"request\",\n      method: pending.method,\n      argsBytes: pending.argsBytes,\n      resultBytes: byteLength(error ?? result),\n      durationMs: Date.now() - pending.startedAt,\n      outcome: error ? \"error\" : \"ok\",\n      errorCode: error?.code,\n      timestamp: new Date().toISOString(),\n      ...pending.extra,\n    };\n\n    if (pending.method === \"initialize\" && result?.serverInfo) {\n      event.serverName = result.serverInfo.name;\n      event.serverVersion = result.serverInfo.version;\n    }\n\n    if (pending.method === \"tools/call\" && !error && result?.isError === true) {\n      event.resultIsError = true;\n    }\n\n    return event;\n  }\n}\n","import type { TelemetryEvent, SdkName, InstallMode } from \"../types.js\";\nimport type { ResolvedConfig } from \"../config.js\";\n\nexport interface BatchMeta {\n  serverName?: string;\n  serverVersion?: string;\n  sdkName: SdkName;\n  sdkVersion?: string;\n  installMode: InstallMode;\n}\n\n/**\n * Ring-buffer batcher: queues events, flushes on a timer or when full, and never\n * throws or retries indefinitely — a failed or unreachable ingest endpoint is a\n * silent no-op, by design (telemetry must never affect the server's own behavior,\n * and the endpoint may not exist yet — see telemetry-master-plan.md §4/§7).\n */\nexport class TelemetryBatcher {\n  private queue: TelemetryEvent[] = [];\n  private timer: ReturnType<typeof setInterval>;\n\n  constructor(\n    private readonly config: ResolvedConfig,\n    private readonly meta: BatchMeta\n  ) {\n    this.timer = setInterval(() => void this.flush(), config.flushIntervalMs);\n    this.timer.unref?.(); // telemetry must never be the reason a process stays alive\n  }\n\n  push(event: TelemetryEvent): void {\n    this.queue.push(event);\n    if (this.queue.length >= this.config.maxBatchSize) void this.flush();\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n    const events = this.queue.splice(0, this.queue.length);\n    try {\n      const response = await fetch(this.config.endpoint, {\n        method: \"POST\",\n        headers: {\n          \"content-type\": \"application/json\",\n          authorization: `Bearer ${this.config.apiKey ?? \"\"}`,\n        },\n        body: JSON.stringify({\n          serverName: this.meta.serverName,\n          serverVersion: this.meta.serverVersion,\n          sdkName: this.meta.sdkName,\n          sdkVersion: this.meta.sdkVersion,\n          installMode: this.meta.installMode,\n          events,\n        }),\n      });\n      // Never throws on a non-2xx (silent drop is still the contract — see class doc),\n      // but a warning is the difference between \"found the bug in 30 seconds\" and\n      // \"found it three days later\": a 404/401/500 here means events are being\n      // discarded even though fetch() itself didn't throw.\n      if (!response.ok) {\n        console.warn(\n          `[mcpfy-pulse] telemetry flush failed: ${response.status} ${response.statusText} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n        );\n      }\n    } catch (err) {\n      console.warn(\n        `[mcpfy-pulse] telemetry flush failed: ${err instanceof Error ? err.message : String(err)} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n      );\n    }\n  }\n\n  async close(): Promise<void> {\n    clearInterval(this.timer);\n    await this.flush();\n  }\n}\n","import { resolveConfig } from \"./config.js\";\nimport { MessageClassifier } from \"./core/classify.js\";\nimport { TelemetryBatcher } from \"./core/batcher.js\";\nimport type { MinimalTransport, TelemetryOptions } from \"./types.js\";\n\n/**\n * Wraps a Transport's `onmessage`/`send` seam to capture telemetry, then delegates\n * everything through to the real transport unchanged. If no API key is configured\n * (via `options.apiKey` or the MCPFY_API_KEY env var), this is a complete no-op —\n * the original transport is returned untouched.\n *\n * Usage (add these lines yourself — nothing here edits your files for you):\n *\n *   import { withMcpfyTelemetry } from \"mcpfy-pulse\";\n *   const transport = new StdioServerTransport();\n *   await server.connect(withMcpfyTelemetry(transport, { apiKey: process.env.MCPFY_API_KEY }));\n */\nexport function withMcpfyTelemetry<T extends MinimalTransport>(transport: T, options?: TelemetryOptions): T {\n  const config = resolveConfig(options);\n  if (!config.apiKey) return transport;\n\n  const classifier = new MessageClassifier();\n  const batcher = new TelemetryBatcher(config, {\n    serverName: options?.serverName,\n    serverVersion: options?.serverVersion,\n    sdkName: options?.sdkName ?? \"@modelcontextprotocol/sdk\",\n    sdkVersion: options?.sdkVersion,\n    installMode: options?.installMode ?? \"sdk-wrapper\",\n  });\n\n  const wrapped: MinimalTransport = {\n    start: () => transport.start(),\n    close: () => {\n      void batcher.close();\n      return transport.close();\n    },\n    send: (message: any, sendOptions?: any) => {\n      const event = classifier.onOutgoing(message);\n      if (event) batcher.push(event);\n      return transport.send(message, sendOptions);\n    },\n    get sessionId() {\n      return transport.sessionId;\n    },\n    get onclose() {\n      return transport.onclose;\n    },\n    set onclose(fn) {\n      transport.onclose = fn;\n    },\n    get onerror() {\n      return transport.onerror;\n    },\n    set onerror(fn) {\n      transport.onerror = fn;\n    },\n    get onmessage() {\n      return transport.onmessage;\n    },\n    set onmessage(handler) {\n      transport.onmessage = (message: any, extra?: any) => {\n        classifier.onIncoming(message);\n        handler?.(message, extra);\n      };\n    },\n  };\n\n  return wrapped as T;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/index.ts","../../src/config.ts","../../src/core/classify.ts","../../src/core/batcher.ts","../../src/wrap-transport.ts"],"sourcesContent":["export { withMcpfyTelemetry } from \"./wrap-transport.js\";\nexport type { TelemetryOptions, TelemetryEvent, MinimalTransport, SdkName, InstallMode } from \"./types.js\";\n","import type { TelemetryOptions } from \"./types.js\";\n\n// Path matches the real route on cloudmcp-nest: POST /v1/telemetry/ingest.\nconst DEFAULT_ENDPOINT = \"https://api.mcpfy.ai/v1/telemetry/ingest\";\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_MAX_BATCH_SIZE = 500;\n\nexport interface ResolvedConfig {\n  apiKey: string | undefined;\n  endpoint: string;\n  flushIntervalMs: number;\n  maxBatchSize: number;\n}\n\nexport function resolveConfig(options?: TelemetryOptions): ResolvedConfig {\n  return {\n    apiKey: options?.apiKey ?? process.env.MCPFY_API_KEY,\n    endpoint: options?.endpoint ?? process.env.MCPFY_TELEMETRY_ENDPOINT ?? DEFAULT_ENDPOINT,\n    flushIntervalMs: options?.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,\n    maxBatchSize: options?.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE,\n  };\n}\n","import type { DeclaredToolMeta, TelemetryEvent } from \"../types.js\";\n\ninterface PendingEntry {\n  method: string;\n  startedAt: number;\n  argsBytes: number;\n  extra: Partial<TelemetryEvent>;\n  progressToken?: string;\n  progressCount: number;\n}\n\nfunction byteLength(value: unknown): number {\n  // `undefined` (no `params` key at all) and `null` (an explicit `\"params\": null`)\n  // both mean \"no meaningful params\" — collapsed to the same 0 here so argsBytes\n  // doesn't swing on a client's JSON-serialization choice. Matches classify.py's\n  // `_byte_length`, which can't tell the two apart once parsed into a dict anyway.\n  if (value === undefined || value === null) return 0;\n  try {\n    return Buffer.byteLength(JSON.stringify(value));\n  } catch {\n    return 0;\n  }\n}\n\n/**\n * Reduces a `tools/list` response's `result.tools` array to non-content metadata —\n * whether/how-long each description is, and how many of its params are individually\n * documented, plus structured-output/annotation presence. Never reads the description\n * text or schema into the event itself.\n */\nfunction extractDeclaredTools(tools: unknown): DeclaredToolMeta[] | undefined {\n  if (!Array.isArray(tools)) return undefined;\n  const declared: DeclaredToolMeta[] = [];\n  for (const tool of tools) {\n    if (!tool || typeof tool.name !== \"string\") continue;\n    const description = typeof tool.description === \"string\" ? tool.description : \"\";\n    const properties = tool.inputSchema?.properties;\n    const paramNames = properties && typeof properties === \"object\" ? Object.keys(properties) : [];\n    const paramsWithDescriptionCount = paramNames.filter(\n      (p) => typeof properties[p]?.description === \"string\" && properties[p].description.trim().length > 0,\n    ).length;\n    const annotations = tool.annotations && typeof tool.annotations === \"object\" ? tool.annotations : undefined;\n    declared.push({\n      name: tool.name,\n      hasDescription: description.trim().length > 0,\n      descriptionLength: description.length,\n      paramCount: paramNames.length,\n      paramsWithDescriptionCount,\n      hasOutputSchema: tool.outputSchema != null && typeof tool.outputSchema === \"object\",\n      readOnlyHint: typeof annotations?.readOnlyHint === \"boolean\" ? annotations.readOnlyHint : undefined,\n      destructiveHint: typeof annotations?.destructiveHint === \"boolean\" ? annotations.destructiveHint : undefined,\n      idempotentHint: typeof annotations?.idempotentHint === \"boolean\" ? annotations.idempotentHint : undefined,\n      openWorldHint: typeof annotations?.openWorldHint === \"boolean\" ? annotations.openWorldHint : undefined,\n    });\n  }\n  return declared;\n}\n\n/**\n * Flattens a `ClientCapabilities`/`ServerCapabilities` object to a list of dotted\n * capability paths that are actually declared — group-presence for capabilities with\n * no meaningful sub-flags, `<group>.<subflag>` for the handful that have one worth\n * surfacing (resources/prompts/tools listChanged, resources.subscribe). `experimental`\n * is deliberately skipped (arbitrary custom capability names, out of scope).\n */\nfunction extractCapabilities(capabilities: unknown): string[] | undefined {\n  if (!capabilities || typeof capabilities !== \"object\") return undefined;\n  const caps = capabilities as Record<string, any>;\n  const out: string[] = [];\n  const GROUPS = [\"sampling\", \"elicitation\", \"roots\", \"tasks\", \"logging\", \"prompts\", \"resources\", \"tools\", \"completions\"];\n  for (const group of GROUPS) {\n    const value = caps[group];\n    if (value === undefined || value === null) continue;\n    out.push(group);\n    if (typeof value === \"object\") {\n      if (value.listChanged === true) out.push(`${group}.listChanged`);\n      if (group === \"resources\" && value.subscribe === true) out.push(`${group}.subscribe`);\n    }\n  }\n  return out.length > 0 ? out : undefined;\n}\n\nfunction extractLabel(method: string, params: any): Partial<TelemetryEvent> {\n  switch (method) {\n    case \"tools/call\":\n      return { toolName: params?.name };\n    case \"prompts/get\":\n      return { promptName: params?.name };\n    case \"resources/read\":\n      return { resourceUri: params?.uri };\n    case \"initialize\": {\n      // Protocol handshake metadata, not user data — same fields the spec itself exchanges in the clear.\n      const label: Partial<TelemetryEvent> = {\n        clientName: params?.clientInfo?.name,\n        clientVersion: params?.clientInfo?.version,\n        protocolVersion: params?.protocolVersion,\n      };\n      const clientCapabilities = extractCapabilities(params?.capabilities);\n      if (clientCapabilities) label.clientCapabilities = clientCapabilities;\n      return label;\n    }\n    default:\n      return {};\n  }\n}\n\n/**\n * Tracks request/response pairs across the two seams every Transport exposes\n * (onmessage = incoming, send = outgoing) and emits one event per completed\n * request. Only method names, byte counts, timing, and outcome are captured —\n * argument values and result content are never read beyond their byte length.\n * The one exception is `tools/list`, where per-tool description/param *presence\n * and length* are captured (never the description text or schema) — see\n * `extractDeclaredTools`.\n *\n * Also tracks a handful of notification types now: `notifications/cancelled` (turns\n * into a completed event with `outcome:\"cancelled\"`, since the original request never\n * gets a response), `notifications/progress` (counted per request, never the progress\n * values themselves), and `notifications/message` plus the three list_changed\n * notifications (emitted as standalone `type:\"notification\"` events). Everything else server-initiated\n * (sampling, elicitation, roots) is still intentionally not tracked — out of scope for\n * this pass.\n */\nexport class MessageClassifier {\n  private pending = new Map<string | number, PendingEntry>();\n  private pendingByToken = new Map<string, string | number>();\n\n  private forgetPending(id: string | number, pending: PendingEntry): void {\n    this.pending.delete(id);\n    if (pending.progressToken !== undefined) this.pendingByToken.delete(pending.progressToken);\n  }\n\n  /**\n   * Returns an event only for the one incoming case that completes a request without\n   * ever seeing a response: a client cancelling its own still-pending request. Every\n   * other incoming message (ordinary requests, `notifications/initialized`, and any\n   * other notification) returns `undefined`, matching prior behavior exactly.\n   */\n  onIncoming(message: any): TelemetryEvent | undefined {\n    if (!message || typeof message !== \"object\") return undefined;\n    const { id, method, params } = message;\n\n    if (id === undefined && method === \"notifications/cancelled\") {\n      // Never read params.reason — free-text, same \"never content\" boundary as everything else.\n      const requestId = params?.requestId;\n      if (requestId === undefined) return undefined;\n      const pending = this.pending.get(requestId);\n      if (!pending) return undefined;\n      this.forgetPending(requestId, pending);\n      return {\n        type: \"request\",\n        method: pending.method,\n        argsBytes: pending.argsBytes,\n        durationMs: Date.now() - pending.startedAt,\n        outcome: \"cancelled\",\n        progressUpdateCount: pending.progressCount,\n        timestamp: new Date().toISOString(),\n        ...pending.extra,\n      };\n    }\n\n    if (id === undefined || !method) return undefined; // only requests carry both an id and a method\n\n    const progressToken = params?._meta?.progressToken;\n    const entry: PendingEntry = {\n      method,\n      startedAt: Date.now(),\n      argsBytes: byteLength(params),\n      extra: extractLabel(method, params),\n      progressCount: 0,\n    };\n    if (typeof progressToken === \"string\" || typeof progressToken === \"number\") {\n      entry.progressToken = String(progressToken);\n      this.pendingByToken.set(entry.progressToken, id);\n    }\n    this.pending.set(id, entry);\n    return undefined;\n  }\n\n  onOutgoing(message: any): TelemetryEvent | undefined {\n    if (!message || typeof message !== \"object\") return undefined;\n    const { id, method, params, result, error } = message;\n\n    if (method && id === undefined) {\n      // An outgoing notification (server -> client) — not a response.\n      if (method === \"notifications/progress\") {\n        const pendingId = this.pendingByToken.get(String(params?.progressToken));\n        if (pendingId !== undefined) {\n          const pending = this.pending.get(pendingId);\n          if (pending) pending.progressCount += 1;\n        }\n        return undefined;\n      }\n      if (method === \"notifications/message\") {\n        return {\n          type: \"notification\",\n          method,\n          logLevel: typeof params?.level === \"string\" ? params.level : undefined,\n          timestamp: new Date().toISOString(),\n        };\n      }\n      if (\n        method === \"notifications/tools/list_changed\" ||\n        method === \"notifications/resources/list_changed\" ||\n        method === \"notifications/prompts/list_changed\"\n      ) {\n        return { type: \"notification\", method, timestamp: new Date().toISOString() };\n      }\n      return undefined; // other notifications / server-initiated requests — still out of scope\n    }\n\n    if (method || id === undefined) return undefined;\n\n    const pending = this.pending.get(id);\n    if (!pending) return undefined;\n    this.forgetPending(id, pending);\n\n    const event: TelemetryEvent = {\n      type: \"request\",\n      method: pending.method,\n      argsBytes: pending.argsBytes,\n      resultBytes: byteLength(error ?? result),\n      durationMs: Date.now() - pending.startedAt,\n      outcome: error ? \"error\" : \"ok\",\n      errorCode: error?.code,\n      progressUpdateCount: pending.progressCount,\n      timestamp: new Date().toISOString(),\n      ...pending.extra,\n    };\n\n    if (pending.method === \"initialize\" && !error) {\n      if (result?.serverInfo) {\n        event.serverName = result.serverInfo.name;\n        event.serverVersion = result.serverInfo.version;\n      }\n      const serverCapabilities = extractCapabilities(result?.capabilities);\n      if (serverCapabilities) event.serverCapabilities = serverCapabilities;\n    }\n\n    if (pending.method === \"tools/call\" && !error && result?.isError === true) {\n      event.resultIsError = true;\n    }\n\n    if (pending.method === \"tools/list\" && !error) {\n      const declaredTools = extractDeclaredTools(result?.tools);\n      if (declaredTools) event.declaredTools = declaredTools;\n    }\n\n    return event;\n  }\n}\n","import type { TelemetryEvent, SdkName, InstallMode } from \"../types.js\";\nimport type { ResolvedConfig } from \"../config.js\";\n\nexport interface BatchMeta {\n  serverName?: string;\n  serverVersion?: string;\n  sdkName: SdkName;\n  sdkVersion?: string;\n  installMode: InstallMode;\n}\n\n/**\n * Ring-buffer batcher: queues events, flushes on a timer or when full, and never\n * throws or retries indefinitely — a failed or unreachable ingest endpoint is a\n * silent no-op, by design (telemetry must never affect the server's own behavior,\n * and the endpoint may not exist yet — see telemetry-master-plan.md §4/§7).\n */\nexport class TelemetryBatcher {\n  private queue: TelemetryEvent[] = [];\n  private timer: ReturnType<typeof setInterval>;\n\n  constructor(\n    private readonly config: ResolvedConfig,\n    private readonly meta: BatchMeta\n  ) {\n    this.timer = setInterval(() => void this.flush(), config.flushIntervalMs);\n    this.timer.unref?.(); // telemetry must never be the reason a process stays alive\n  }\n\n  push(event: TelemetryEvent): void {\n    this.queue.push(event);\n    if (this.queue.length >= this.config.maxBatchSize) void this.flush();\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n    const events = this.queue.splice(0, this.queue.length);\n    try {\n      const response = await fetch(this.config.endpoint, {\n        method: \"POST\",\n        headers: {\n          \"content-type\": \"application/json\",\n          authorization: `Bearer ${this.config.apiKey ?? \"\"}`,\n        },\n        body: JSON.stringify({\n          serverName: this.meta.serverName,\n          serverVersion: this.meta.serverVersion,\n          sdkName: this.meta.sdkName,\n          sdkVersion: this.meta.sdkVersion,\n          installMode: this.meta.installMode,\n          events,\n        }),\n      });\n      // Never throws on a non-2xx (silent drop is still the contract — see class doc),\n      // but a warning is the difference between \"found the bug in 30 seconds\" and\n      // \"found it three days later\": a 404/401/500 here means events are being\n      // discarded even though fetch() itself didn't throw.\n      if (!response.ok) {\n        console.warn(\n          `[mcpfy-pulse] telemetry flush failed: ${response.status} ${response.statusText} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n        );\n      }\n    } catch (err) {\n      console.warn(\n        `[mcpfy-pulse] telemetry flush failed: ${err instanceof Error ? err.message : String(err)} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n      );\n    }\n  }\n\n  async close(): Promise<void> {\n    clearInterval(this.timer);\n    await this.flush();\n  }\n}\n","import { resolveConfig } from \"./config.js\";\nimport { MessageClassifier } from \"./core/classify.js\";\nimport { TelemetryBatcher } from \"./core/batcher.js\";\nimport type { MinimalTransport, TelemetryOptions } from \"./types.js\";\n\n/**\n * Wraps a Transport's `onmessage`/`send` seam to capture telemetry, then delegates\n * everything through to the real transport unchanged. If no API key is configured\n * (via `options.apiKey` or the MCPFY_API_KEY env var), this is a complete no-op —\n * the original transport is returned untouched.\n *\n * Usage (add these lines yourself — nothing here edits your files for you):\n *\n *   import { withMcpfyTelemetry } from \"mcpfy-pulse\";\n *   const transport = new StdioServerTransport();\n *   await server.connect(withMcpfyTelemetry(transport, { apiKey: process.env.MCPFY_API_KEY }));\n */\nexport function withMcpfyTelemetry<T extends MinimalTransport>(transport: T, options?: TelemetryOptions): T {\n  const config = resolveConfig(options);\n  if (!config.apiKey) return transport;\n\n  const classifier = new MessageClassifier();\n  const batcher = new TelemetryBatcher(config, {\n    serverName: options?.serverName,\n    serverVersion: options?.serverVersion,\n    sdkName: options?.sdkName ?? \"@modelcontextprotocol/sdk\",\n    sdkVersion: options?.sdkVersion,\n    installMode: options?.installMode ?? \"sdk-wrapper\",\n  });\n\n  const wrapped: MinimalTransport = {\n    start: () => transport.start(),\n    close: () => {\n      void batcher.close();\n      return transport.close();\n    },\n    send: (message: any, sendOptions?: any) => {\n      const event = classifier.onOutgoing(message);\n      if (event) batcher.push(event);\n      return transport.send(message, sendOptions);\n    },\n    get sessionId() {\n      return transport.sessionId;\n    },\n    get onclose() {\n      return transport.onclose;\n    },\n    set onclose(fn) {\n      transport.onclose = fn;\n    },\n    get onerror() {\n      return transport.onerror;\n    },\n    set onerror(fn) {\n      transport.onerror = fn;\n    },\n    get onmessage() {\n      return transport.onmessage;\n    },\n    set onmessage(handler) {\n      transport.onmessage = (message: any, extra?: any) => {\n        const event = classifier.onIncoming(message);\n        if (event) batcher.push(event);\n        handler?.(message, extra);\n      };\n    },\n  };\n\n  return wrapped as T;\n}\n"],"mappings":"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","names":["pending"]}

package/dist/src/index.js

@@ -13,13 +13,56 @@ function resolveConfig(options) {
 
 // src/core/classify.ts
 function byteLength(value) {
-  if (value === void 0) return 0;
+  if (value === void 0 || value === null) return 0;
   try {
     return Buffer.byteLength(JSON.stringify(value));
   } catch {
     return 0;
   }
 }
+function extractDeclaredTools(tools) {
+  if (!Array.isArray(tools)) return void 0;
+  const declared = [];
+  for (const tool of tools) {
+    if (!tool || typeof tool.name !== "string") continue;
+    const description = typeof tool.description === "string" ? tool.description : "";
+    const properties = tool.inputSchema?.properties;
+    const paramNames = properties && typeof properties === "object" ? Object.keys(properties) : [];
+    const paramsWithDescriptionCount = paramNames.filter(
+      (p) => typeof properties[p]?.description === "string" && properties[p].description.trim().length > 0
+    ).length;
+    const annotations = tool.annotations && typeof tool.annotations === "object" ? tool.annotations : void 0;
+    declared.push({
+      name: tool.name,
+      hasDescription: description.trim().length > 0,
+      descriptionLength: description.length,
+      paramCount: paramNames.length,
+      paramsWithDescriptionCount,
+      hasOutputSchema: tool.outputSchema != null && typeof tool.outputSchema === "object",
+      readOnlyHint: typeof annotations?.readOnlyHint === "boolean" ? annotations.readOnlyHint : void 0,
+      destructiveHint: typeof annotations?.destructiveHint === "boolean" ? annotations.destructiveHint : void 0,
+      idempotentHint: typeof annotations?.idempotentHint === "boolean" ? annotations.idempotentHint : void 0,
+      openWorldHint: typeof annotations?.openWorldHint === "boolean" ? annotations.openWorldHint : void 0
+    });
+  }
+  return declared;
+}
+function extractCapabilities(capabilities) {
+  if (!capabilities || typeof capabilities !== "object") return void 0;
+  const caps = capabilities;
+  const out = [];
+  const GROUPS = ["sampling", "elicitation", "roots", "tasks", "logging", "prompts", "resources", "tools", "completions"];
+  for (const group of GROUPS) {
+    const value = caps[group];
+    if (value === void 0 || value === null) continue;
+    out.push(group);
+    if (typeof value === "object") {
+      if (value.listChanged === true) out.push(`${group}.listChanged`);
+      if (group === "resources" && value.subscribe === true) out.push(`${group}.subscribe`);
+    }
+  }
+  return out.length > 0 ? out : void 0;
+}
 function extractLabel(method, params) {
   switch (method) {
     case "tools/call":
@@ -28,36 +71,98 @@ function extractLabel(method, params) {
       return { promptName: params?.name };
     case "resources/read":
       return { resourceUri: params?.uri };
-    case "initialize":
-      return {
+    case "initialize": {
+      const label = {
         clientName: params?.clientInfo?.name,
         clientVersion: params?.clientInfo?.version,
         protocolVersion: params?.protocolVersion
       };
+      const clientCapabilities = extractCapabilities(params?.capabilities);
+      if (clientCapabilities) label.clientCapabilities = clientCapabilities;
+      return label;
+    }
     default:
       return {};
   }
 }
 var MessageClassifier = class {
   pending = /* @__PURE__ */ new Map();
+  pendingByToken = /* @__PURE__ */ new Map();
+  forgetPending(id, pending) {
+    this.pending.delete(id);
+    if (pending.progressToken !== void 0) this.pendingByToken.delete(pending.progressToken);
+  }
+  /**
+   * Returns an event only for the one incoming case that completes a request without
+   * ever seeing a response: a client cancelling its own still-pending request. Every
+   * other incoming message (ordinary requests, `notifications/initialized`, and any
+   * other notification) returns `undefined`, matching prior behavior exactly.
+   */
   onIncoming(message) {
-    if (!message || typeof message !== "object") return;
+    if (!message || typeof message !== "object") return void 0;
     const { id, method, params } = message;
-    if (id === void 0 || !method) return;
-    this.pending.set(id, {
+    if (id === void 0 && method === "notifications/cancelled") {
+      const requestId = params?.requestId;
+      if (requestId === void 0) return void 0;
+      const pending = this.pending.get(requestId);
+      if (!pending) return void 0;
+      this.forgetPending(requestId, pending);
+      return {
+        type: "request",
+        method: pending.method,
+        argsBytes: pending.argsBytes,
+        durationMs: Date.now() - pending.startedAt,
+        outcome: "cancelled",
+        progressUpdateCount: pending.progressCount,
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        ...pending.extra
+      };
+    }
+    if (id === void 0 || !method) return void 0;
+    const progressToken = params?._meta?.progressToken;
+    const entry = {
       method,
       startedAt: Date.now(),
       argsBytes: byteLength(params),
-      extra: extractLabel(method, params)
-    });
+      extra: extractLabel(method, params),
+      progressCount: 0
+    };
+    if (typeof progressToken === "string" || typeof progressToken === "number") {
+      entry.progressToken = String(progressToken);
+      this.pendingByToken.set(entry.progressToken, id);
+    }
+    this.pending.set(id, entry);
+    return void 0;
   }
   onOutgoing(message) {
     if (!message || typeof message !== "object") return void 0;
-    const { id, method, result, error } = message;
+    const { id, method, params, result, error } = message;
+    if (method && id === void 0) {
+      if (method === "notifications/progress") {
+        const pendingId = this.pendingByToken.get(String(params?.progressToken));
+        if (pendingId !== void 0) {
+          const pending2 = this.pending.get(pendingId);
+          if (pending2) pending2.progressCount += 1;
+        }
+        return void 0;
+      }
+      if (method === "notifications/message") {
+        return {
+          type: "notification",
+          method,
+          logLevel: typeof params?.level === "string" ? params.level : void 0,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        };
+      }
+      if (method === "notifications/tools/list_changed" || method === "notifications/resources/list_changed" || method === "notifications/prompts/list_changed") {
+        return { type: "notification", method, timestamp: (/* @__PURE__ */ new Date()).toISOString() };
+      }
+      return void 0;
+    }
     if (method || id === void 0) return void 0;
     const pending = this.pending.get(id);
     if (!pending) return void 0;
-    this.pending.delete(id);
+    this.forgetPending(id, pending);
     const event = {
       type: "request",
       method: pending.method,
@@ -66,16 +171,25 @@ var MessageClassifier = class {
       durationMs: Date.now() - pending.startedAt,
       outcome: error ? "error" : "ok",
       errorCode: error?.code,
+      progressUpdateCount: pending.progressCount,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       ...pending.extra
     };
-    if (pending.method === "initialize" && result?.serverInfo) {
-      event.serverName = result.serverInfo.name;
-      event.serverVersion = result.serverInfo.version;
+    if (pending.method === "initialize" && !error) {
+      if (result?.serverInfo) {
+        event.serverName = result.serverInfo.name;
+        event.serverVersion = result.serverInfo.version;
+      }
+      const serverCapabilities = extractCapabilities(result?.capabilities);
+      if (serverCapabilities) event.serverCapabilities = serverCapabilities;
     }
     if (pending.method === "tools/call" && !error && result?.isError === true) {
       event.resultIsError = true;
     }
+    if (pending.method === "tools/list" && !error) {
+      const declaredTools = extractDeclaredTools(result?.tools);
+      if (declaredTools) event.declaredTools = declaredTools;
+    }
     return event;
   }
 };
@@ -175,7 +289,8 @@ function withMcpfyTelemetry(transport, options) {
     },
     set onmessage(handler) {
       transport.onmessage = (message, extra) => {
-        classifier.onIncoming(message);
+        const event = classifier.onIncoming(message);
+        if (event) batcher.push(event);
         handler?.(message, extra);
       };
     }

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/config.ts","../../src/core/classify.ts","../../src/core/batcher.ts","../../src/wrap-transport.ts"],"sourcesContent":["import type { TelemetryOptions } from \"./types.js\";\n\n// Path matches the real route on cloudmcp-nest: POST /v1/telemetry/ingest.\nconst DEFAULT_ENDPOINT = \"https://api.mcpfy.ai/v1/telemetry/ingest\";\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_MAX_BATCH_SIZE = 500;\n\nexport interface ResolvedConfig {\n  apiKey: string | undefined;\n  endpoint: string;\n  flushIntervalMs: number;\n  maxBatchSize: number;\n}\n\nexport function resolveConfig(options?: TelemetryOptions): ResolvedConfig {\n  return {\n    apiKey: options?.apiKey ?? process.env.MCPFY_API_KEY,\n    endpoint: options?.endpoint ?? process.env.MCPFY_TELEMETRY_ENDPOINT ?? DEFAULT_ENDPOINT,\n    flushIntervalMs: options?.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,\n    maxBatchSize: options?.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE,\n  };\n}\n","import type { TelemetryEvent } from \"../types.js\";\n\ninterface PendingEntry {\n  method: string;\n  startedAt: number;\n  argsBytes: number;\n  extra: Partial<TelemetryEvent>;\n}\n\nfunction byteLength(value: unknown): number {\n  if (value === undefined) return 0;\n  try {\n    return Buffer.byteLength(JSON.stringify(value));\n  } catch {\n    return 0;\n  }\n}\n\nfunction extractLabel(method: string, params: any): Partial<TelemetryEvent> {\n  switch (method) {\n    case \"tools/call\":\n      return { toolName: params?.name };\n    case \"prompts/get\":\n      return { promptName: params?.name };\n    case \"resources/read\":\n      return { resourceUri: params?.uri };\n    case \"initialize\":\n      // Protocol handshake metadata, not user data — same fields the spec itself exchanges in the clear.\n      return {\n        clientName: params?.clientInfo?.name,\n        clientVersion: params?.clientInfo?.version,\n        protocolVersion: params?.protocolVersion,\n      };\n    default:\n      return {};\n  }\n}\n\n/**\n * Tracks request/response pairs across the two seams every Transport exposes\n * (onmessage = incoming, send = outgoing) and emits one event per completed\n * request. Only method names, byte counts, timing, and outcome are captured —\n * argument values and result content are never read beyond their byte length.\n *\n * Server-initiated requests/notifications (sampling, elicitation, logging,\n * progress) are intentionally not tracked yet — out of scope for this pass.\n */\nexport class MessageClassifier {\n  private pending = new Map<string | number, PendingEntry>();\n\n  onIncoming(message: any): void {\n    if (!message || typeof message !== \"object\") return;\n    const { id, method, params } = message;\n    if (id === undefined || !method) return; // only requests carry both an id and a method\n    this.pending.set(id, {\n      method,\n      startedAt: Date.now(),\n      argsBytes: byteLength(params),\n      extra: extractLabel(method, params),\n    });\n  }\n\n  onOutgoing(message: any): TelemetryEvent | undefined {\n    if (!message || typeof message !== \"object\") return undefined;\n    const { id, method, result, error } = message;\n    if (method || id === undefined) return undefined;\n\n    const pending = this.pending.get(id);\n    if (!pending) return undefined;\n    this.pending.delete(id);\n\n    const event: TelemetryEvent = {\n      type: \"request\",\n      method: pending.method,\n      argsBytes: pending.argsBytes,\n      resultBytes: byteLength(error ?? result),\n      durationMs: Date.now() - pending.startedAt,\n      outcome: error ? \"error\" : \"ok\",\n      errorCode: error?.code,\n      timestamp: new Date().toISOString(),\n      ...pending.extra,\n    };\n\n    if (pending.method === \"initialize\" && result?.serverInfo) {\n      event.serverName = result.serverInfo.name;\n      event.serverVersion = result.serverInfo.version;\n    }\n\n    if (pending.method === \"tools/call\" && !error && result?.isError === true) {\n      event.resultIsError = true;\n    }\n\n    return event;\n  }\n}\n","import type { TelemetryEvent, SdkName, InstallMode } from \"../types.js\";\nimport type { ResolvedConfig } from \"../config.js\";\n\nexport interface BatchMeta {\n  serverName?: string;\n  serverVersion?: string;\n  sdkName: SdkName;\n  sdkVersion?: string;\n  installMode: InstallMode;\n}\n\n/**\n * Ring-buffer batcher: queues events, flushes on a timer or when full, and never\n * throws or retries indefinitely — a failed or unreachable ingest endpoint is a\n * silent no-op, by design (telemetry must never affect the server's own behavior,\n * and the endpoint may not exist yet — see telemetry-master-plan.md §4/§7).\n */\nexport class TelemetryBatcher {\n  private queue: TelemetryEvent[] = [];\n  private timer: ReturnType<typeof setInterval>;\n\n  constructor(\n    private readonly config: ResolvedConfig,\n    private readonly meta: BatchMeta\n  ) {\n    this.timer = setInterval(() => void this.flush(), config.flushIntervalMs);\n    this.timer.unref?.(); // telemetry must never be the reason a process stays alive\n  }\n\n  push(event: TelemetryEvent): void {\n    this.queue.push(event);\n    if (this.queue.length >= this.config.maxBatchSize) void this.flush();\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n    const events = this.queue.splice(0, this.queue.length);\n    try {\n      const response = await fetch(this.config.endpoint, {\n        method: \"POST\",\n        headers: {\n          \"content-type\": \"application/json\",\n          authorization: `Bearer ${this.config.apiKey ?? \"\"}`,\n        },\n        body: JSON.stringify({\n          serverName: this.meta.serverName,\n          serverVersion: this.meta.serverVersion,\n          sdkName: this.meta.sdkName,\n          sdkVersion: this.meta.sdkVersion,\n          installMode: this.meta.installMode,\n          events,\n        }),\n      });\n      // Never throws on a non-2xx (silent drop is still the contract — see class doc),\n      // but a warning is the difference between \"found the bug in 30 seconds\" and\n      // \"found it three days later\": a 404/401/500 here means events are being\n      // discarded even though fetch() itself didn't throw.\n      if (!response.ok) {\n        console.warn(\n          `[mcpfy-pulse] telemetry flush failed: ${response.status} ${response.statusText} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n        );\n      }\n    } catch (err) {\n      console.warn(\n        `[mcpfy-pulse] telemetry flush failed: ${err instanceof Error ? err.message : String(err)} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n      );\n    }\n  }\n\n  async close(): Promise<void> {\n    clearInterval(this.timer);\n    await this.flush();\n  }\n}\n","import { resolveConfig } from \"./config.js\";\nimport { MessageClassifier } from \"./core/classify.js\";\nimport { TelemetryBatcher } from \"./core/batcher.js\";\nimport type { MinimalTransport, TelemetryOptions } from \"./types.js\";\n\n/**\n * Wraps a Transport's `onmessage`/`send` seam to capture telemetry, then delegates\n * everything through to the real transport unchanged. If no API key is configured\n * (via `options.apiKey` or the MCPFY_API_KEY env var), this is a complete no-op —\n * the original transport is returned untouched.\n *\n * Usage (add these lines yourself — nothing here edits your files for you):\n *\n *   import { withMcpfyTelemetry } from \"mcpfy-pulse\";\n *   const transport = new StdioServerTransport();\n *   await server.connect(withMcpfyTelemetry(transport, { apiKey: process.env.MCPFY_API_KEY }));\n */\nexport function withMcpfyTelemetry<T extends MinimalTransport>(transport: T, options?: TelemetryOptions): T {\n  const config = resolveConfig(options);\n  if (!config.apiKey) return transport;\n\n  const classifier = new MessageClassifier();\n  const batcher = new TelemetryBatcher(config, {\n    serverName: options?.serverName,\n    serverVersion: options?.serverVersion,\n    sdkName: options?.sdkName ?? \"@modelcontextprotocol/sdk\",\n    sdkVersion: options?.sdkVersion,\n    installMode: options?.installMode ?? \"sdk-wrapper\",\n  });\n\n  const wrapped: MinimalTransport = {\n    start: () => transport.start(),\n    close: () => {\n      void batcher.close();\n      return transport.close();\n    },\n    send: (message: any, sendOptions?: any) => {\n      const event = classifier.onOutgoing(message);\n      if (event) batcher.push(event);\n      return transport.send(message, sendOptions);\n    },\n    get sessionId() {\n      return transport.sessionId;\n    },\n    get onclose() {\n      return transport.onclose;\n    },\n    set onclose(fn) {\n      transport.onclose = fn;\n    },\n    get onerror() {\n      return transport.onerror;\n    },\n    set onerror(fn) {\n      transport.onerror = fn;\n    },\n    get onmessage() {\n      return transport.onmessage;\n    },\n    set onmessage(handler) {\n      transport.onmessage = (message: any, extra?: any) => {\n        classifier.onIncoming(message);\n        handler?.(message, extra);\n      };\n    },\n  };\n\n  return wrapped as T;\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/config.ts","../../src/core/classify.ts","../../src/core/batcher.ts","../../src/wrap-transport.ts"],"sourcesContent":["import type { TelemetryOptions } from \"./types.js\";\n\n// Path matches the real route on cloudmcp-nest: POST /v1/telemetry/ingest.\nconst DEFAULT_ENDPOINT = \"https://api.mcpfy.ai/v1/telemetry/ingest\";\nconst DEFAULT_FLUSH_INTERVAL_MS = 5000;\nconst DEFAULT_MAX_BATCH_SIZE = 500;\n\nexport interface ResolvedConfig {\n  apiKey: string | undefined;\n  endpoint: string;\n  flushIntervalMs: number;\n  maxBatchSize: number;\n}\n\nexport function resolveConfig(options?: TelemetryOptions): ResolvedConfig {\n  return {\n    apiKey: options?.apiKey ?? process.env.MCPFY_API_KEY,\n    endpoint: options?.endpoint ?? process.env.MCPFY_TELEMETRY_ENDPOINT ?? DEFAULT_ENDPOINT,\n    flushIntervalMs: options?.flushIntervalMs ?? DEFAULT_FLUSH_INTERVAL_MS,\n    maxBatchSize: options?.maxBatchSize ?? DEFAULT_MAX_BATCH_SIZE,\n  };\n}\n","import type { DeclaredToolMeta, TelemetryEvent } from \"../types.js\";\n\ninterface PendingEntry {\n  method: string;\n  startedAt: number;\n  argsBytes: number;\n  extra: Partial<TelemetryEvent>;\n  progressToken?: string;\n  progressCount: number;\n}\n\nfunction byteLength(value: unknown): number {\n  // `undefined` (no `params` key at all) and `null` (an explicit `\"params\": null`)\n  // both mean \"no meaningful params\" — collapsed to the same 0 here so argsBytes\n  // doesn't swing on a client's JSON-serialization choice. Matches classify.py's\n  // `_byte_length`, which can't tell the two apart once parsed into a dict anyway.\n  if (value === undefined || value === null) return 0;\n  try {\n    return Buffer.byteLength(JSON.stringify(value));\n  } catch {\n    return 0;\n  }\n}\n\n/**\n * Reduces a `tools/list` response's `result.tools` array to non-content metadata —\n * whether/how-long each description is, and how many of its params are individually\n * documented, plus structured-output/annotation presence. Never reads the description\n * text or schema into the event itself.\n */\nfunction extractDeclaredTools(tools: unknown): DeclaredToolMeta[] | undefined {\n  if (!Array.isArray(tools)) return undefined;\n  const declared: DeclaredToolMeta[] = [];\n  for (const tool of tools) {\n    if (!tool || typeof tool.name !== \"string\") continue;\n    const description = typeof tool.description === \"string\" ? tool.description : \"\";\n    const properties = tool.inputSchema?.properties;\n    const paramNames = properties && typeof properties === \"object\" ? Object.keys(properties) : [];\n    const paramsWithDescriptionCount = paramNames.filter(\n      (p) => typeof properties[p]?.description === \"string\" && properties[p].description.trim().length > 0,\n    ).length;\n    const annotations = tool.annotations && typeof tool.annotations === \"object\" ? tool.annotations : undefined;\n    declared.push({\n      name: tool.name,\n      hasDescription: description.trim().length > 0,\n      descriptionLength: description.length,\n      paramCount: paramNames.length,\n      paramsWithDescriptionCount,\n      hasOutputSchema: tool.outputSchema != null && typeof tool.outputSchema === \"object\",\n      readOnlyHint: typeof annotations?.readOnlyHint === \"boolean\" ? annotations.readOnlyHint : undefined,\n      destructiveHint: typeof annotations?.destructiveHint === \"boolean\" ? annotations.destructiveHint : undefined,\n      idempotentHint: typeof annotations?.idempotentHint === \"boolean\" ? annotations.idempotentHint : undefined,\n      openWorldHint: typeof annotations?.openWorldHint === \"boolean\" ? annotations.openWorldHint : undefined,\n    });\n  }\n  return declared;\n}\n\n/**\n * Flattens a `ClientCapabilities`/`ServerCapabilities` object to a list of dotted\n * capability paths that are actually declared — group-presence for capabilities with\n * no meaningful sub-flags, `<group>.<subflag>` for the handful that have one worth\n * surfacing (resources/prompts/tools listChanged, resources.subscribe). `experimental`\n * is deliberately skipped (arbitrary custom capability names, out of scope).\n */\nfunction extractCapabilities(capabilities: unknown): string[] | undefined {\n  if (!capabilities || typeof capabilities !== \"object\") return undefined;\n  const caps = capabilities as Record<string, any>;\n  const out: string[] = [];\n  const GROUPS = [\"sampling\", \"elicitation\", \"roots\", \"tasks\", \"logging\", \"prompts\", \"resources\", \"tools\", \"completions\"];\n  for (const group of GROUPS) {\n    const value = caps[group];\n    if (value === undefined || value === null) continue;\n    out.push(group);\n    if (typeof value === \"object\") {\n      if (value.listChanged === true) out.push(`${group}.listChanged`);\n      if (group === \"resources\" && value.subscribe === true) out.push(`${group}.subscribe`);\n    }\n  }\n  return out.length > 0 ? out : undefined;\n}\n\nfunction extractLabel(method: string, params: any): Partial<TelemetryEvent> {\n  switch (method) {\n    case \"tools/call\":\n      return { toolName: params?.name };\n    case \"prompts/get\":\n      return { promptName: params?.name };\n    case \"resources/read\":\n      return { resourceUri: params?.uri };\n    case \"initialize\": {\n      // Protocol handshake metadata, not user data — same fields the spec itself exchanges in the clear.\n      const label: Partial<TelemetryEvent> = {\n        clientName: params?.clientInfo?.name,\n        clientVersion: params?.clientInfo?.version,\n        protocolVersion: params?.protocolVersion,\n      };\n      const clientCapabilities = extractCapabilities(params?.capabilities);\n      if (clientCapabilities) label.clientCapabilities = clientCapabilities;\n      return label;\n    }\n    default:\n      return {};\n  }\n}\n\n/**\n * Tracks request/response pairs across the two seams every Transport exposes\n * (onmessage = incoming, send = outgoing) and emits one event per completed\n * request. Only method names, byte counts, timing, and outcome are captured —\n * argument values and result content are never read beyond their byte length.\n * The one exception is `tools/list`, where per-tool description/param *presence\n * and length* are captured (never the description text or schema) — see\n * `extractDeclaredTools`.\n *\n * Also tracks a handful of notification types now: `notifications/cancelled` (turns\n * into a completed event with `outcome:\"cancelled\"`, since the original request never\n * gets a response), `notifications/progress` (counted per request, never the progress\n * values themselves), and `notifications/message` plus the three list_changed\n * notifications (emitted as standalone `type:\"notification\"` events). Everything else server-initiated\n * (sampling, elicitation, roots) is still intentionally not tracked — out of scope for\n * this pass.\n */\nexport class MessageClassifier {\n  private pending = new Map<string | number, PendingEntry>();\n  private pendingByToken = new Map<string, string | number>();\n\n  private forgetPending(id: string | number, pending: PendingEntry): void {\n    this.pending.delete(id);\n    if (pending.progressToken !== undefined) this.pendingByToken.delete(pending.progressToken);\n  }\n\n  /**\n   * Returns an event only for the one incoming case that completes a request without\n   * ever seeing a response: a client cancelling its own still-pending request. Every\n   * other incoming message (ordinary requests, `notifications/initialized`, and any\n   * other notification) returns `undefined`, matching prior behavior exactly.\n   */\n  onIncoming(message: any): TelemetryEvent | undefined {\n    if (!message || typeof message !== \"object\") return undefined;\n    const { id, method, params } = message;\n\n    if (id === undefined && method === \"notifications/cancelled\") {\n      // Never read params.reason — free-text, same \"never content\" boundary as everything else.\n      const requestId = params?.requestId;\n      if (requestId === undefined) return undefined;\n      const pending = this.pending.get(requestId);\n      if (!pending) return undefined;\n      this.forgetPending(requestId, pending);\n      return {\n        type: \"request\",\n        method: pending.method,\n        argsBytes: pending.argsBytes,\n        durationMs: Date.now() - pending.startedAt,\n        outcome: \"cancelled\",\n        progressUpdateCount: pending.progressCount,\n        timestamp: new Date().toISOString(),\n        ...pending.extra,\n      };\n    }\n\n    if (id === undefined || !method) return undefined; // only requests carry both an id and a method\n\n    const progressToken = params?._meta?.progressToken;\n    const entry: PendingEntry = {\n      method,\n      startedAt: Date.now(),\n      argsBytes: byteLength(params),\n      extra: extractLabel(method, params),\n      progressCount: 0,\n    };\n    if (typeof progressToken === \"string\" || typeof progressToken === \"number\") {\n      entry.progressToken = String(progressToken);\n      this.pendingByToken.set(entry.progressToken, id);\n    }\n    this.pending.set(id, entry);\n    return undefined;\n  }\n\n  onOutgoing(message: any): TelemetryEvent | undefined {\n    if (!message || typeof message !== \"object\") return undefined;\n    const { id, method, params, result, error } = message;\n\n    if (method && id === undefined) {\n      // An outgoing notification (server -> client) — not a response.\n      if (method === \"notifications/progress\") {\n        const pendingId = this.pendingByToken.get(String(params?.progressToken));\n        if (pendingId !== undefined) {\n          const pending = this.pending.get(pendingId);\n          if (pending) pending.progressCount += 1;\n        }\n        return undefined;\n      }\n      if (method === \"notifications/message\") {\n        return {\n          type: \"notification\",\n          method,\n          logLevel: typeof params?.level === \"string\" ? params.level : undefined,\n          timestamp: new Date().toISOString(),\n        };\n      }\n      if (\n        method === \"notifications/tools/list_changed\" ||\n        method === \"notifications/resources/list_changed\" ||\n        method === \"notifications/prompts/list_changed\"\n      ) {\n        return { type: \"notification\", method, timestamp: new Date().toISOString() };\n      }\n      return undefined; // other notifications / server-initiated requests — still out of scope\n    }\n\n    if (method || id === undefined) return undefined;\n\n    const pending = this.pending.get(id);\n    if (!pending) return undefined;\n    this.forgetPending(id, pending);\n\n    const event: TelemetryEvent = {\n      type: \"request\",\n      method: pending.method,\n      argsBytes: pending.argsBytes,\n      resultBytes: byteLength(error ?? result),\n      durationMs: Date.now() - pending.startedAt,\n      outcome: error ? \"error\" : \"ok\",\n      errorCode: error?.code,\n      progressUpdateCount: pending.progressCount,\n      timestamp: new Date().toISOString(),\n      ...pending.extra,\n    };\n\n    if (pending.method === \"initialize\" && !error) {\n      if (result?.serverInfo) {\n        event.serverName = result.serverInfo.name;\n        event.serverVersion = result.serverInfo.version;\n      }\n      const serverCapabilities = extractCapabilities(result?.capabilities);\n      if (serverCapabilities) event.serverCapabilities = serverCapabilities;\n    }\n\n    if (pending.method === \"tools/call\" && !error && result?.isError === true) {\n      event.resultIsError = true;\n    }\n\n    if (pending.method === \"tools/list\" && !error) {\n      const declaredTools = extractDeclaredTools(result?.tools);\n      if (declaredTools) event.declaredTools = declaredTools;\n    }\n\n    return event;\n  }\n}\n","import type { TelemetryEvent, SdkName, InstallMode } from \"../types.js\";\nimport type { ResolvedConfig } from \"../config.js\";\n\nexport interface BatchMeta {\n  serverName?: string;\n  serverVersion?: string;\n  sdkName: SdkName;\n  sdkVersion?: string;\n  installMode: InstallMode;\n}\n\n/**\n * Ring-buffer batcher: queues events, flushes on a timer or when full, and never\n * throws or retries indefinitely — a failed or unreachable ingest endpoint is a\n * silent no-op, by design (telemetry must never affect the server's own behavior,\n * and the endpoint may not exist yet — see telemetry-master-plan.md §4/§7).\n */\nexport class TelemetryBatcher {\n  private queue: TelemetryEvent[] = [];\n  private timer: ReturnType<typeof setInterval>;\n\n  constructor(\n    private readonly config: ResolvedConfig,\n    private readonly meta: BatchMeta\n  ) {\n    this.timer = setInterval(() => void this.flush(), config.flushIntervalMs);\n    this.timer.unref?.(); // telemetry must never be the reason a process stays alive\n  }\n\n  push(event: TelemetryEvent): void {\n    this.queue.push(event);\n    if (this.queue.length >= this.config.maxBatchSize) void this.flush();\n  }\n\n  async flush(): Promise<void> {\n    if (this.queue.length === 0) return;\n    const events = this.queue.splice(0, this.queue.length);\n    try {\n      const response = await fetch(this.config.endpoint, {\n        method: \"POST\",\n        headers: {\n          \"content-type\": \"application/json\",\n          authorization: `Bearer ${this.config.apiKey ?? \"\"}`,\n        },\n        body: JSON.stringify({\n          serverName: this.meta.serverName,\n          serverVersion: this.meta.serverVersion,\n          sdkName: this.meta.sdkName,\n          sdkVersion: this.meta.sdkVersion,\n          installMode: this.meta.installMode,\n          events,\n        }),\n      });\n      // Never throws on a non-2xx (silent drop is still the contract — see class doc),\n      // but a warning is the difference between \"found the bug in 30 seconds\" and\n      // \"found it three days later\": a 404/401/500 here means events are being\n      // discarded even though fetch() itself didn't throw.\n      if (!response.ok) {\n        console.warn(\n          `[mcpfy-pulse] telemetry flush failed: ${response.status} ${response.statusText} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n        );\n      }\n    } catch (err) {\n      console.warn(\n        `[mcpfy-pulse] telemetry flush failed: ${err instanceof Error ? err.message : String(err)} (${this.config.endpoint}) — ${events.length} event(s) dropped`\n      );\n    }\n  }\n\n  async close(): Promise<void> {\n    clearInterval(this.timer);\n    await this.flush();\n  }\n}\n","import { resolveConfig } from \"./config.js\";\nimport { MessageClassifier } from \"./core/classify.js\";\nimport { TelemetryBatcher } from \"./core/batcher.js\";\nimport type { MinimalTransport, TelemetryOptions } from \"./types.js\";\n\n/**\n * Wraps a Transport's `onmessage`/`send` seam to capture telemetry, then delegates\n * everything through to the real transport unchanged. If no API key is configured\n * (via `options.apiKey` or the MCPFY_API_KEY env var), this is a complete no-op —\n * the original transport is returned untouched.\n *\n * Usage (add these lines yourself — nothing here edits your files for you):\n *\n *   import { withMcpfyTelemetry } from \"mcpfy-pulse\";\n *   const transport = new StdioServerTransport();\n *   await server.connect(withMcpfyTelemetry(transport, { apiKey: process.env.MCPFY_API_KEY }));\n */\nexport function withMcpfyTelemetry<T extends MinimalTransport>(transport: T, options?: TelemetryOptions): T {\n  const config = resolveConfig(options);\n  if (!config.apiKey) return transport;\n\n  const classifier = new MessageClassifier();\n  const batcher = new TelemetryBatcher(config, {\n    serverName: options?.serverName,\n    serverVersion: options?.serverVersion,\n    sdkName: options?.sdkName ?? \"@modelcontextprotocol/sdk\",\n    sdkVersion: options?.sdkVersion,\n    installMode: options?.installMode ?? \"sdk-wrapper\",\n  });\n\n  const wrapped: MinimalTransport = {\n    start: () => transport.start(),\n    close: () => {\n      void batcher.close();\n      return transport.close();\n    },\n    send: (message: any, sendOptions?: any) => {\n      const event = classifier.onOutgoing(message);\n      if (event) batcher.push(event);\n      return transport.send(message, sendOptions);\n    },\n    get sessionId() {\n      return transport.sessionId;\n    },\n    get onclose() {\n      return transport.onclose;\n    },\n    set onclose(fn) {\n      transport.onclose = fn;\n    },\n    get onerror() {\n      return transport.onerror;\n    },\n    set onerror(fn) {\n      transport.onerror = fn;\n    },\n    get onmessage() {\n      return transport.onmessage;\n    },\n    set onmessage(handler) {\n      transport.onmessage = (message: any, extra?: any) => {\n        const event = classifier.onIncoming(message);\n        if (event) batcher.push(event);\n        handler?.(message, extra);\n      };\n    },\n  };\n\n  return wrapped as T;\n}\n"],"mappings":"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","names":["pending"]}

package/dist/src/proxy/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/proxy/run.ts"],"names":[],"mappings":"AAmCA;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAuD5D"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/proxy/run.ts"],"names":[],"mappings":"AAmCA;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD5D"}

package/dist/src/types.d.ts

@@ -15,6 +15,31 @@ export interface MinimalTransport {
 }
 export type SdkName = "mcpfy-sdk" | "@modelcontextprotocol/sdk" | "unknown";
 export type InstallMode = "sdk-env" | "sdk-wrapper" | "stdio-proxy";
+/**
+ * One declared tool from a `tools/list` response, reduced to lightweight metadata —
+ * never the description text or schema itself, same "never content" treatment as
+ * everything else this package captures. Powers capability-gap / orphan-tool /
+ * description-quality scoring server-side without ever shipping the actual text.
+ */
+export interface DeclaredToolMeta {
+    name: string;
+    hasDescription: boolean;
+    descriptionLength: number;
+    paramCount: number;
+    paramsWithDescriptionCount: number;
+    /** Whether the tool declares `outputSchema` (structured-output support) — presence only. */
+    hasOutputSchema: boolean;
+    /**
+     * `Tool.annotations` hints, read as-is — `undefined` means "not declared," never
+     * coerced to the MCP spec's nominal defaults (e.g. `destructiveHint` defaults to
+     * `true` when absent per spec). Applying that default would mislabel every tool
+     * that simply didn't declare annotations as destructive.
+     */
+    readOnlyHint?: boolean;
+    destructiveHint?: boolean;
+    idempotentHint?: boolean;
+    openWorldHint?: boolean;
+}
 export interface TelemetryOptions {
     /** Defaults to the MCPFY_API_KEY env var. Unset (in either form) = no-op, nothing is sent. */
     apiKey?: string;
@@ -33,7 +58,12 @@ export interface TelemetryOptions {
  * never argument values or result content. See telemetry-master-plan.md §2-3.
  */
 export interface TelemetryEvent {
-    type: "request";
+    /**
+     * "request" = a completed (or cancelled) request/response pair. "notification" = a
+     * standalone, fire-and-forget message with no matching request (log messages,
+     * list_changed) — see `logLevel` below for the one field notification events carry.
+     */
+    type: "request" | "notification";
     method: string;
     toolName?: string;
     promptName?: string;
@@ -46,9 +76,33 @@ export interface TelemetryEvent {
     argsBytes?: number;
     resultBytes?: number;
     durationMs?: number;
-    outcome?: "ok" | "error";
+    /**
+     * "cancelled" means the client sent `notifications/cancelled` for this request before
+     * a response arrived — `durationMs` then measures time-to-cancel, not completion time.
+     */
+    outcome?: "ok" | "error" | "cancelled";
     errorCode?: number;
     timestamp: string;
+    /**
+     * Count of `notifications/progress` messages correlated to this request via its
+     * `_meta.progressToken`, before it completed. Always present (default 0) on completed
+     * request events — a tool-hygiene signal ("does this tool report progress"), not the
+     * progress values themselves (never captured).
+     */
+    progressUpdateCount?: number;
+    /**
+     * `type:"notification"`, `method:"notifications/message"` only — the log level
+     * (MCP's `LoggingLevel`). Never `params.data` (arbitrary log payload) or the logger name.
+     */
+    logLevel?: string;
+    /**
+     * `initialize` only: which optional capabilities each side declared, as a flat list of
+     * dotted paths (e.g. `["resources.subscribe", "tools.listChanged", "logging"]`) —
+     * group-presence for simple capabilities, a dotted sub-flag for the handful with
+     * meaningful booleans. `experimental` capabilities are never included.
+     */
+    clientCapabilities?: string[];
+    serverCapabilities?: string[];
     /**
      * `tools/call` only: the result's own `isError` flag (MCP's CallToolResult.isError) —
      * a tool that ran fine at the JSON-RPC level (outcome:"ok") but reports its own
@@ -57,5 +111,10 @@ export interface TelemetryEvent {
      * result content itself.
      */
     resultIsError?: boolean;
+    /**
+     * `tools/list` only: the declared tool catalog, reduced to non-content metadata.
+     * See `DeclaredToolMeta`.
+     */
+    declaredTools?: DeclaredToolMeta[];
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;IAChD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,2BAA2B,GAAG,SAAS,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/wrap-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap-transport.d.ts","sourceRoot":"","sources":["../../src/wrap-transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,gBAAgB,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAmD1G"}
+{"version":3,"file":"wrap-transport.d.ts","sourceRoot":"","sources":["../../src/wrap-transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,gBAAgB,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,CAAC,CAoD1G"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcpfy-pulse",
   "type": "module",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Telemetry for MCP servers: wrap any Transport, or proxy any command over stdio, to capture method/size/duration/outcome metrics for the MCPFY dashboard. Never sends argument values or resource content.",
   "author": "mcpfy",
   "license": "MIT",