mcpspan 0.1.0 → 0.2.0

package/README.md

@@ -208,8 +208,9 @@ out of this as well.
 mode, not in debug.
 
 What is collected: the tool name, how long it took, whether it succeeded, the
-error type and a truncated message when it did not, which client called, and
-the SDK version. For a resource or a prompt, the same, under the name it was
+error type and a truncated message when it did not, how large the answer was
+in bytes (its size only, never its content), which client called, and the SDK
+version. For a resource or a prompt, the same, under the name it was
 registered with: never the address a client read, only its template or, for
 an address the server does not have, its scheme.
 

package/dist/index.cjs

@@ -146,7 +146,7 @@ var EventQueue = class {
 * Single source of truth: `package.json` follows this constant, not the other
 * way round, and a unit test fails if the two ever drift apart.
 */
-const SDK_VERSION = "0.1.0";
+const SDK_VERSION = "0.2.0";
 //#endregion
 //#region src/transport.ts
 /** Path the ingest API accepts batches on, appended to the configured endpoint. */
@@ -782,15 +782,21 @@ function track(toolName, handler) {
 				recorded = true;
 				return;
 			}
+			const size = responseBytes(value);
+			const measured = size === void 0 ? {} : { responseBytes: size };
 			if (!isErrorResult(value)) {
-				emit({ success: true });
+				emit({
+					success: true,
+					...measured
+				});
 				return;
 			}
 			const errorMessage = describeErrorResult(value);
 			emit({
 				success: false,
 				errorSource: "result",
-				...errorMessage !== void 0 && { errorMessage }
+				...errorMessage !== void 0 && { errorMessage },
+				...measured
 			});
 		};
 		const fail = (error) => {
@@ -903,7 +909,8 @@ function recordPrimitiveCall(call) {
 			...parameters !== void 0 && { parameters },
 			timestamp: call.timestamp,
 			sdkVersion: SDK_VERSION,
-			...call.sessionId !== void 0 && { sessionId: call.sessionId }
+			...call.sessionId !== void 0 && { sessionId: call.sessionId },
+			...call.responseBytes !== void 0 && { responseBytes: call.responseBytes }
 		});
 	} catch {}
 }
@@ -911,6 +918,21 @@ function recordPrimitiveCall(call) {
 function isRecording() {
 	return sink !== void 0;
 }
+/** The largest size an event carries; anything larger is sent as this (contract, 3.7). */
+const MAX_RESPONSE_BYTES = 2147483647;
+/**
+* Size of an answer, in bytes of its compact JSON (contract, 3.7), or undefined
+* when it cannot be encoded. The JSON is counted and dropped: nothing of it is
+* kept or sent.
+*/
+function responseBytes(value) {
+	try {
+		const json = JSON.stringify(value);
+		return json === void 0 ? void 0 : Math.min(Buffer.byteLength(json, "utf8"), MAX_RESPONSE_BYTES);
+	} catch {
+		return;
+	}
+}
 /** A result the 2026-07-28 protocol calls interim: the tool needs more input first. */
 function isInputRequired(value) {
 	return typeof value === "object" && value !== null && value.resultType === "input_required";
@@ -1226,7 +1248,8 @@ function watchPrimitive(handler, server) {
 					durationMs: performance.now() - startedAt,
 					sessionId: typeof context === "object" && context !== null ? sessionFor(server, context) : void 0,
 					client: clientFor(server, typeof context === "object" && context !== null ? context : void 0),
-					serverVersion: serverVersionOf(server)
+					serverVersion: serverVersionOf(server),
+					responseBytes: outcome.responseBytes
 				});
 			} catch {}
 		};
@@ -1249,7 +1272,10 @@ function watchPrimitive(handler, server) {
 			});
 			throw error;
 		}
-		if (!(typeof result === "object" && result !== null && result.resultType === "input_required")) record({ success: true });
+		if (!(typeof result === "object" && result !== null && result.resultType === "input_required")) record({
+			success: true,
+			responseBytes: responseBytes(result)
+		});
 		return result;
 	};
 }

package/dist/index.d.cts

@@ -194,6 +194,11 @@ interface ToolCallEvent {
    * the version the MCP server gives itself.
    */
   serverVersion?: string;
+  /**
+   * Size of the answer, in bytes of compact JSON (contract, 3.7). Only when the
+   * call returned one; the content is counted, never kept.
+   */
+  responseBytes?: number;
   /** When the call started, as an ISO 8601 timestamp. */
   timestamp: string;
   /** Version of the mcpspan package that produced the event. */

package/dist/index.d.mts

@@ -194,6 +194,11 @@ interface ToolCallEvent {
    * the version the MCP server gives itself.
    */
   serverVersion?: string;
+  /**
+   * Size of the answer, in bytes of compact JSON (contract, 3.7). Only when the
+   * call returned one; the content is counted, never kept.
+   */
+  responseBytes?: number;
   /** When the call started, as an ISO 8601 timestamp. */
   timestamp: string;
   /** Version of the mcpspan package that produced the event. */

package/dist/index.mjs

@@ -145,7 +145,7 @@ var EventQueue = class {
 * Single source of truth: `package.json` follows this constant, not the other
 * way round, and a unit test fails if the two ever drift apart.
 */
-const SDK_VERSION = "0.1.0";
+const SDK_VERSION = "0.2.0";
 //#endregion
 //#region src/transport.ts
 /** Path the ingest API accepts batches on, appended to the configured endpoint. */
@@ -781,15 +781,21 @@ function track(toolName, handler) {
 				recorded = true;
 				return;
 			}
+			const size = responseBytes(value);
+			const measured = size === void 0 ? {} : { responseBytes: size };
 			if (!isErrorResult(value)) {
-				emit({ success: true });
+				emit({
+					success: true,
+					...measured
+				});
 				return;
 			}
 			const errorMessage = describeErrorResult(value);
 			emit({
 				success: false,
 				errorSource: "result",
-				...errorMessage !== void 0 && { errorMessage }
+				...errorMessage !== void 0 && { errorMessage },
+				...measured
 			});
 		};
 		const fail = (error) => {
@@ -902,7 +908,8 @@ function recordPrimitiveCall(call) {
 			...parameters !== void 0 && { parameters },
 			timestamp: call.timestamp,
 			sdkVersion: SDK_VERSION,
-			...call.sessionId !== void 0 && { sessionId: call.sessionId }
+			...call.sessionId !== void 0 && { sessionId: call.sessionId },
+			...call.responseBytes !== void 0 && { responseBytes: call.responseBytes }
 		});
 	} catch {}
 }
@@ -910,6 +917,21 @@ function recordPrimitiveCall(call) {
 function isRecording() {
 	return sink !== void 0;
 }
+/** The largest size an event carries; anything larger is sent as this (contract, 3.7). */
+const MAX_RESPONSE_BYTES = 2147483647;
+/**
+* Size of an answer, in bytes of its compact JSON (contract, 3.7), or undefined
+* when it cannot be encoded. The JSON is counted and dropped: nothing of it is
+* kept or sent.
+*/
+function responseBytes(value) {
+	try {
+		const json = JSON.stringify(value);
+		return json === void 0 ? void 0 : Math.min(Buffer.byteLength(json, "utf8"), MAX_RESPONSE_BYTES);
+	} catch {
+		return;
+	}
+}
 /** A result the 2026-07-28 protocol calls interim: the tool needs more input first. */
 function isInputRequired(value) {
 	return typeof value === "object" && value !== null && value.resultType === "input_required";
@@ -1225,7 +1247,8 @@ function watchPrimitive(handler, server) {
 					durationMs: performance.now() - startedAt,
 					sessionId: typeof context === "object" && context !== null ? sessionFor(server, context) : void 0,
 					client: clientFor(server, typeof context === "object" && context !== null ? context : void 0),
-					serverVersion: serverVersionOf(server)
+					serverVersion: serverVersionOf(server),
+					responseBytes: outcome.responseBytes
 				});
 			} catch {}
 		};
@@ -1248,7 +1271,10 @@ function watchPrimitive(handler, server) {
 			});
 			throw error;
 		}
-		if (!(typeof result === "object" && result !== null && result.resultType === "input_required")) record({ success: true });
+		if (!(typeof result === "object" && result !== null && result.resultType === "input_required")) record({
+			success: true,
+			responseBytes: responseBytes(result)
+		});
 		return result;
 	};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcpspan",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Self-hosted analytics for MCP servers: which tools, resources and prompts get used, by which client, how fast, and why they fail.",
   "keywords": [
     "mcp",