@knownagents/sdk 2.0.0 → 2.1.0

package/README.md

@@ -24,86 +24,84 @@ const knownAgents = new KnownAgents("YOUR_ACCESS_TOKEN")
 
 ## How To Set Up Agent & LLM Analytics ([Full Docs](https://knownagents.com/docs/analytics))
 
-Get realtime insight into the hidden ecosystem of [AI agents and other bots](https://knownagents.com/agents) browsing your website, REST APIs, and [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) servers. Measure human traffic coming from AI chat and search platforms like ChatGPT, Perplexity, and Gemini.
+Get realtime insight into how [AI agents and other bots](https://knownagents.com/agents) browse your web pages, call your [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) endpoints, and purchase products through your [ACP (Agentic Commerce Protocol)](https://www.agenticcommerce.dev/) and [UCP (Universal Commerce Protocol)](https://ucp.dev/) shopping flows. Measure human traffic from AI chat and search platforms like ChatGPT, Claude, and Gemini.
 
-### Track Pageview and REST Calls
+### Track Pageviews and REST Calls
 
-To collect pageview and REST API analytics, call `trackPageviewOrRESTCall` with the incoming Node.js request and response.
+Call `trackPageviewOrRESTCall` with the incoming request and outgoing response. If you can, do this in middleware.
 
 ```ts
 knownAgents.trackPageviewOrRESTCall(request, response)
 ```
 
-For REST APIs that return [ACP (Agentic Commerce Protocol)](https://www.agenticcommerce.dev/) or [UCP (Universal Commerce Protocol)](https://ucp.dev/) commerce metadata, include the response body:
+MCP calls are skipped automatically by `trackPageviewOrRESTCall`. Use `trackMCPCall` to track MCP calls.
 
-```ts
-knownAgents.trackPageviewOrRESTCall(request, response, {
-    restACPResponseBody: acpResponseBody
-})
-```
+High-traffic websites should not use this method. Instead, batch visits and send them periodically with `trackVisits` (see below).
+
+#### Agentic Commerce Calls
+
+For REST implementations of ACP and UCP, include the response body.
 
 ```ts
+// For ACP calls ...
+
 knownAgents.trackPageviewOrRESTCall(request, response, {
-    restUCPResponseBody: ucpResponseBody
+    acpResponseBody: acpResponseBody
 })
 ```
 
-The SDK waits for the response to finish, then sends status, headers, duration, and any commerce metadata. Sensitive headers are filtered automatically.
-
-#### Use Middleware if Possible
-
-If your framework supports middleware, call `trackPageviewOrRESTCall` there so pageviews and REST calls are tracked from a single place. [MCP](https://modelcontextprotocol.io/) requests are skipped automatically.
-
 ```ts
-import express from "express"
-import { KnownAgents } from "@knownagents/sdk"
-
-const app = express()
-const knownAgents = new KnownAgents("YOUR_ACCESS_TOKEN")
+// For UCP calls ...
 
-app.use((request, response, next) => {
-    knownAgents.trackPageviewOrRESTCall(request, response)
-    next()
-})
-
-app.get("/", (request, response) => {
-    response.send("Hello, world!")
+knownAgents.trackPageviewOrRESTCall(request, response, {
+    ucpResponseBody: ucpResponseBody
 })
-
-app.listen(3000, () => console.log("Server running on port 3000"))
 ```
 
 ### Track MCP Calls
 
-For [MCP](https://modelcontextprotocol.io/) servers that use `StreamableHTTPServerTransport`, call `trackMCPCall` after connecting the transport and before the transport handles the request.
+For MCP servers that use `StreamableHTTPServerTransport`, call `trackMCPCall` after connecting the transport and before the transport handles the request.
 
-For MCP calls that return [ACP](https://www.agenticcommerce.dev/) or [UCP](https://ucp.dev/) commerce metadata, the SDK captures the relevant currency and total amount automatically.
-
-Use this order in your MCP HTTP handler:
+High-traffic websites, or those that use the same transport instance to handle multiple concurrent requests, should not use this method. Instead, batch visits and send them periodically with `trackVisits` (see below).
 
 ```ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js"
 
+// ...
+
+const mcpServer = new McpServer({
+    name: SERVER_NAME,
+    version: SERVER_VERSION,
+})
+
 const transport = new StreamableHTTPServerTransport({
     sessionIdGenerator: undefined
 })
 
+// ...
+
 await mcpServer.connect(transport)
+
 knownAgents.trackMCPCall(request, response, transport)
+
 await transport.handleRequest(request, response, parsedBody)
 ```
 
-Use `trackVisits` instead if the same transport instance handles concurrent requests.
+#### Agentic Commerce Calls
+
+This method will track MCP implementations of ACP and UCP automatically.
 
-### Batching
+### Batching for High-Traffic Websites
 
-For high-traffic websites, batch multiple visits together and send them periodically (e.g. every 30 seconds) using `trackVisits`. `trackVisits` can also batch MCP visits; if you do that, include the MCP fields in each `VisitRequest` and do not also call `trackMCPCall` for the same requests. Here's an Express example:
+High-traffic websites should batch multiple visits together and send them periodically (e.g. every 30 seconds) using `trackVisits`. This method can track pageviews, REST, MCP, ACP, and UCP calls. Here's an example with Express middleware:
 
 ```ts
 import express from "express"
 import { KnownAgents, type VisitRequest } from "@knownagents/sdk"
 
 const app = express()
+
 const knownAgents = new KnownAgents("YOUR_ACCESS_TOKEN")
 const visits: VisitRequest[] = []
 
@@ -140,13 +138,13 @@ setInterval(() => {
 - Click **Send a Test Visit**
 - Click **Realtime**
 
-If your website is correctly connected, you should see visits from the Known Agent in the realtime timeline within a few seconds.
+If your website is correctly connected, you should see visits from a test agent in the realtime timeline within a few seconds.
 
 ## How To Set Up Automatic Robots.txt ([Full Docs](https://knownagents.com/docs/robots-txt))
 
-Protect sensitive content from unwanted access and scraping. Generate a continuously updating robots.txt that stays up to date with [all current and future bots](https://knownagents.com/agents) in the specified categories automatically.
+Serve a robots.txt that continuously updates with rules for new [crawlers, scrapers, AI agents, and other bots](https://knownagents.com/agents) as they're discovered.
 
-Use the `generateRobotsTXT` function. Select which `AgentType`s you want to block, and a string specifying which URLs are disallowed (e.g. `"/"` to disallow all paths).
+Use the `generateRobotsTXT` method. Select which `AgentType`s you want to block, and a string specifying which URLs are disallowed (e.g. `"/"` to disallow all paths).
 
 ```ts
 import { AgentType } from "@knownagents/sdk"
@@ -159,29 +157,19 @@ const robotsTxt = await knownAgents.generateRobotsTXT([
 ], "/")
 ```
 
-The return value is a plain text robots.txt string. Generate a `robotsTxt` periodically (e.g. once per day), then cache and serve it from your website's `/robots.txt` endpoint.
-
-## How To Use Agent Identification ([Full Docs](https://knownagents.com/docs/identification))
+The return value is a plain text robots.txt string. Generate a `robotsTxt` periodically (e.g. once per day, using a cron job). Then, serve it from your website's `/robots.txt` endpoint.
 
-Use the `identifyAgent` and `identifyAgents` functions to identify and verify [AI agents and bots](https://knownagents.com/agents) from network requests using Web Bot Auth (HTTP message signatures), IP matching, or other available methods. This can be useful for implementing access policies based on verified agent identity or enriching your own datasets.
+## How To Use the Agent Identification API ([Full Docs](https://knownagents.com/docs/identification))
 
-### Identify a Single Request
+Identify and verify [AI agents and other bots](https://knownagents.com/agents) in your own products, from incoming network requests. Authentication uses Web Bot Auth (HTTP message signatures), IP matching, or other available methods. This API can be useful for implementing access policies based on verified agent identity or enriching your own datasets.
 
-Call `identifyAgent` with the incoming request.
+Call `identifyAgent` to identify a single incoming request:
 
 ```ts
 const identification = await knownAgents.identifyAgent(request)
-
-if (identification.result === "verified") {
-    handleVerifiedAgent(identification)
-} else if (identification.result === "verification_failed") {
-    handleFailedVerification(identification)
-}
 ```
 
-### Identify Multiple Requests
-
-Use `identifyAgents` to identify multiple requests at once:
+Call `identifyAgents` to identify multiple requests at once:
 
 ```ts
 const identifications = await knownAgents.identifyAgents([
@@ -196,7 +184,7 @@ const identifications = await knownAgents.identifyAgents([
 ])
 ```
 
-The functions return an object (or array of objects) with the following fields:
+These methods return an object (or array of objects) with the following fields:
 
 - `id`: The identifier from the request (if provided)
 - `result`: The identification result:

package/dist/KnownAgents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KnownAgents.d.ts","sourceRoot":"","sources":["../src/KnownAgents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAA;AAC3D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAA;AAavG,OAAO,KAAK,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,EAC9B,YAAY,EACf,MAAM,SAAS,CAAA;AAqChB;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAEpC;;;;OAIG;gBACS,WAAW,EAAE,MAAM;IAI/B;;;;;;;;OAQG;IACH,uBAAuB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,IAAI;IAsC3H;;;;;;;;;OASG;IACH,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,6BAA6B,GAAG,IAAI;IAuEhH;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IA6B3C;;;;;;;;;OASG;IACG,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBzF;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmB5E;;;;;;;OAOG;IACG,cAAc,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAsB3F"}
+{"version":3,"file":"KnownAgents.d.ts","sourceRoot":"","sources":["../src/KnownAgents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAA;AAC3D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,oDAAoD,CAAA;AAGvG,OAAO,KAAK,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,EAC9B,YAAY,EACf,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IAEpC;;;;OAIG;gBACS,WAAW,EAAE,MAAM;IAI/B;;;;;;;;OAQG;IACH,uBAAuB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,8BAA8B,GAAG,IAAI;IAoC3H;;;;;;;;;OASG;IACH,YAAY,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,6BAA6B,GAAG,IAAI;IAqEhH;;;;;;OAMG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IA6B3C;;;;;;;;;OASG;IACG,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAoBzF;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAmB5E;;;;;;;OAOG;IACG,cAAc,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;CAsB3F"}

package/dist/KnownAgents.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.KnownAgents = void 0;
-const commerce_1 = require("./commerce");
 const headers_1 = require("./headers");
 const paths_1 = require("./paths");
 /**
@@ -42,10 +41,8 @@ class KnownAgents {
                 response_status_code: response?.statusCode,
                 response_headers: response.getHeaders(),
                 response_duration_in_milliseconds: responseDurationInMilliseconds,
-                acp_response_currency: options?.restACPResponseBody ? (0, commerce_1.getRESTACPCurrencyIfPossible)(options?.restACPResponseBody) : undefined,
-                acp_response_total_amount: options?.restACPResponseBody ? (0, commerce_1.getRESTACPTotalAmountIfPossible)(options?.restACPResponseBody) : undefined,
-                ucp_response_currency: options?.restUCPResponseBody ? (0, commerce_1.getRESTUCPCurrencyIfPossible)(options?.restUCPResponseBody) : undefined,
-                ucp_response_total_amount: options?.restUCPResponseBody ? (0, commerce_1.getRESTUCPTotalAmountIfPossible)(options?.restUCPResponseBody) : undefined,
+                acp_response_body: options?.acpResponseBody,
+                ucp_response_body: options?.ucpResponseBody,
                 created: created.toISOString()
             };
             this.trackVisits([visitRequest]);
@@ -68,10 +65,9 @@ class KnownAgents {
      * @param transport - The MCP streamable HTTP transport handling the request.
      */
     trackMCPCall(request, response, transport) {
-        const isMCPCall = (0, headers_1.getIsMCPCall)(request.headers);
         const path = request.url;
         const method = request.method;
-        if (!isMCPCall || !path || (0, paths_1.getIsPathExcluded)(path) || !method) {
+        if (!path || (0, paths_1.getIsPathExcluded)(path) || !method) {
             return;
         }
         const created = new Date();
@@ -97,6 +93,7 @@ class KnownAgents {
                 return;
             }
             const responseDurationInMilliseconds = Date.now() - created.getTime();
+            const mcpResponseResult = mcpResponseBody.result?.structuredContent ?? mcpResponseBody.result;
             const visitRequest = {
                 request_path: path,
                 request_method: method,
@@ -111,10 +108,8 @@ class KnownAgents {
                 mcp_response_result_is_error: mcpResponseBody.result?.isError,
                 mcp_response_error_code: mcpResponseBody.error?.code,
                 mcp_response_error_message: mcpResponseBody.error?.message,
-                acp_response_currency: (0, commerce_1.getMCPACPCurrencyIfPossible)(request, mcpResponseBody),
-                acp_response_total_amount: (0, commerce_1.getMCPACPTotalAmountIfPossible)(request, mcpResponseBody),
-                ucp_response_currency: (0, commerce_1.getMCPUCPCurrencyIfPossible)(request, mcpResponseBody),
-                ucp_response_total_amount: (0, commerce_1.getMCPUCPTotalAmountIfPossible)(request, mcpResponseBody),
+                acp_response_body: (0, headers_1.getIsACPCall)(request.headers) ? mcpResponseResult : undefined,
+                ucp_response_body: (0, headers_1.getIsUCPCall)(request.headers) ? mcpResponseResult : undefined,
                 created: created.toISOString()
             };
             this.trackVisits([visitRequest]);

package/dist/headers.d.ts

@@ -2,5 +2,5 @@ import type { IncomingHttpHeaders, OutgoingHttpHeaders } from "http";
 export declare function getFilteredHeaders<Headers extends IncomingHttpHeaders | OutgoingHttpHeaders>(headers: Headers): Headers;
 export declare function getIsMCPCall(headers: IncomingHttpHeaders): boolean;
 export declare function getIsUCPCall(headers: IncomingHttpHeaders): boolean;
-export declare function getIsProbablyACPCall(headers: IncomingHttpHeaders): boolean;
+export declare function getIsACPCall(headers: IncomingHttpHeaders): boolean;
 //# sourceMappingURL=headers.d.ts.map

package/dist/headers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAA;AA2BpE,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAUvH;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAIlE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAIlE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAI1E"}
+{"version":3,"file":"headers.d.ts","sourceRoot":"","sources":["../src/headers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAA;AA2BpE,wBAAgB,kBAAkB,CAAC,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAUvH;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAIlE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAIlE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAIlE"}

package/dist/headers.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getFilteredHeaders = getFilteredHeaders;
 exports.getIsMCPCall = getIsMCPCall;
 exports.getIsUCPCall = getIsUCPCall;
-exports.getIsProbablyACPCall = getIsProbablyACPCall;
+exports.getIsACPCall = getIsACPCall;
 const filteredHeaderNames = [
     "authorization",
     "proxy-authorization",
@@ -47,8 +47,8 @@ function getIsUCPCall(headers) {
         return key.toLowerCase() === "ucp-agent";
     });
 }
-function getIsProbablyACPCall(headers) {
-    return Object.keys(headers).some((key) => {
+function getIsACPCall(headers) {
+    return !getIsUCPCall(headers) && Object.keys(headers).some((key) => {
         return key.toLowerCase() === "api-version";
     });
 }

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { KnownAgents } from "./KnownAgents";
-export { AgentType, type IdentificationRequest, type IdentificationResult, type RESTACPResponseBody, type RESTUCPResponseBody, type TrackPageviewOrRESTCallOptions, type VisitRequest } from "./types";
+export { AgentType, type IdentificationRequest, type IdentificationResult, type TrackPageviewOrRESTCallOptions, type VisitRequest } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EACH,SAAS,EACT,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EACnC,KAAK,YAAY,EACpB,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,OAAO,EACH,SAAS,EACT,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,8BAA8B,EACnC,KAAK,YAAY,EACpB,MAAM,SAAS,CAAA"}

package/dist/types.d.ts

@@ -1,36 +1,12 @@
 import type { IncomingHttpHeaders, OutgoingHttpHeaders } from "http";
-/**
- * ACP response details from a REST API call.
- */
-export interface RESTACPResponseBody {
-    /** The response currency, usually an ISO 4217 code. */
-    currency?: string;
-    /** ACP totals returned by the REST endpoint. The "total" item is sent to Known Agents. */
-    totals?: {
-        type?: string;
-        amount?: number;
-    }[];
-}
-/**
- * UCP response details from a REST API call.
- */
-export interface RESTUCPResponseBody {
-    /** The response currency, usually an ISO 4217 code. */
-    currency?: string;
-    /** UCP totals returned by the REST endpoint. The "total" item is sent to Known Agents. */
-    totals?: {
-        type?: string;
-        amount?: number;
-    }[];
-}
 /**
  * Additional metadata to include when tracking a pageview or REST API call.
  */
 export interface TrackPageviewOrRESTCallOptions {
-    /** ACP response body from the REST endpoint. */
-    restACPResponseBody?: RESTACPResponseBody;
-    /** UCP response body from the REST endpoint. */
-    restUCPResponseBody?: RESTUCPResponseBody;
+    /** The ACP response body. */
+    acpResponseBody?: Record<string, unknown>;
+    /** The UCP response body. */
+    ucpResponseBody?: Record<string, unknown>;
 }
 /**
  * A normalized visit payload for the Known Agents API.
@@ -63,14 +39,10 @@ export interface VisitRequest {
     mcp_response_error_code?: number;
     /** The MCP response error message */
     mcp_response_error_message?: string;
-    /** The ACP response currency */
-    acp_response_currency?: string;
-    /** The ACP response "total" amount */
-    acp_response_total_amount?: number;
-    /** The UCP response currency */
-    ucp_response_currency?: string;
-    /** The UCP response "total" amount */
-    ucp_response_total_amount?: number;
+    /** The ACP response body */
+    acp_response_body?: Record<string, unknown>;
+    /** The UCP response body */
+    ucp_response_body?: Record<string, unknown>;
     /** The timestamp when the visit occurred (ISO 8601 format) */
     created?: string;
 }

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,MAAM,CAAA;AAEpE;;GAEG;AACH,MAAM,WAAW,8BAA8B;IAC3C,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACzC,6BAA6B;IAC7B,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC5C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,2EAA2E;IAC3E,YAAY,EAAE,MAAM,CAAA;IACpB,2CAA2C;IAC3C,cAAc,EAAE,MAAM,CAAA;IACtB,8EAA8E;IAC9E,eAAe,EAAE,mBAAmB,CAAA;IACpC,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,mBAAmB,CAAA;IACtC,4CAA4C;IAC5C,iCAAiC,CAAC,EAAE,MAAM,CAAA;IAC1C,sCAAsC;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,gCAAgC;IAChC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,kCAAkC;IAClC,4BAA4B,CAAC,EAAE,MAAM,CAAA;IACrC,qCAAqC;IACrC,+BAA+B,CAAC,EAAE,MAAM,CAAA;IACxC,kDAAkD;IAClD,4BAA4B,CAAC,EAAE,OAAO,CAAA;IACtC,kCAAkC;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAA;IAChC,qCAAqC;IACrC,0BAA0B,CAAC,EAAE,MAAM,CAAA;IACnC,4BAA4B;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3C,4BAA4B;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC3C,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAClC,4FAA4F;IAC5F,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,8EAA8E;IAC9E,eAAe,EAAE,mBAAmB,CAAA;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC,oDAAoD;IACpD,EAAE,CAAC,EAAE,MAAM,CAAA;IACX;;;;;;OAMG;IACH,MAAM,EAAE,UAAU,GAAG,qBAAqB,GAAG,eAAe,GAAG,gBAAgB,CAAA;IAC/E,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,8DAA8D;IAC9D,aAAa,CAAC,EAAE,MAAM,CAAA;CACzB;AAED;;GAEG;AACH,oBAAY,SAAS;IACjB,OAAO,aAAa;IACpB,WAAW,iBAAiB;IAC5B,aAAa,oBAAoB;IACjC,cAAc,qBAAqB;IACnC,aAAa,oBAAoB;IACjC,eAAe,sBAAsB;IACrC,QAAQ,aAAa;IACrB,cAAc,oBAAoB;IAClC,eAAe,qBAAqB;IACpC,OAAO,YAAY;IACnB,oBAAoB,0BAA0B;IAC9C,OAAO,YAAY;IACnB,UAAU,gBAAgB;IAC1B,mBAAmB,0BAA0B;IAC7C,eAAe,qBAAqB;IACpC,mBAAmB,0BAA0B;CAChD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@knownagents/sdk",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "The official Node.js SDK for Known Agents: AI agent analytics (bot traffic), LLM referral tracking, automatic robots.txt, agent verification",
   "publishConfig": {
     "access": "public"

package/src/KnownAgents.ts

@@ -1,16 +1,6 @@
 import type { IncomingMessage, ServerResponse } from "http"
 import type { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js"
-import {
-    getMCPACPCurrencyIfPossible,
-    getMCPACPTotalAmountIfPossible,
-    getMCPUCPCurrencyIfPossible,
-    getMCPUCPTotalAmountIfPossible,
-    getRESTACPCurrencyIfPossible,
-    getRESTACPTotalAmountIfPossible,
-    getRESTUCPCurrencyIfPossible,
-    getRESTUCPTotalAmountIfPossible
-} from "./commerce"
-import { getFilteredHeaders, getIsMCPCall } from "./headers"
+import { getFilteredHeaders, getIsACPCall, getIsMCPCall, getIsUCPCall } from "./headers"
 import { getIsPathExcluded } from "./paths"
 import type {
     AgentType,
@@ -20,41 +10,6 @@ import type {
     VisitRequest
 } from "./types"
 
-interface MCPRequestBody {
-    jsonrpc: string
-    method: string
-    params?: {
-        name?: string
-        clientInfo?: {
-            name?: string
-            version?: string
-        }
-    }
-}
-
-interface MCPResponseBody {
-    jsonrpc: string
-    result?: {
-        isError?: boolean
-        currency?: string
-        totals?: {
-            type?: string
-            amount?: number
-        }[]
-        structuredContent?: {
-            currency?: string
-            totals?: {
-                type?: string
-                amount?: number
-            }[]
-        }
-    }
-    error?: {
-        code?: number
-        message?: string
-    }
-}
-
 /**
  * Server-side client for Known Agents analytics, robots.txt generation, and agent identification.
  */
@@ -100,10 +55,8 @@ export class KnownAgents {
                 response_status_code: response?.statusCode,
                 response_headers: response.getHeaders(),
                 response_duration_in_milliseconds: responseDurationInMilliseconds,
-                acp_response_currency: options?.restACPResponseBody ? getRESTACPCurrencyIfPossible(options?.restACPResponseBody) : undefined,
-                acp_response_total_amount: options?.restACPResponseBody ? getRESTACPTotalAmountIfPossible(options?.restACPResponseBody) : undefined,
-                ucp_response_currency: options?.restUCPResponseBody ? getRESTUCPCurrencyIfPossible(options?.restUCPResponseBody) : undefined,
-                ucp_response_total_amount: options?.restUCPResponseBody ? getRESTUCPTotalAmountIfPossible(options?.restUCPResponseBody) : undefined,
+                acp_response_body: options?.acpResponseBody,
+                ucp_response_body: options?.ucpResponseBody,
                 created: created.toISOString()
             }
 
@@ -128,28 +81,27 @@ export class KnownAgents {
      * @param transport - The MCP streamable HTTP transport handling the request.
      */
     trackMCPCall(request: IncomingMessage, response: ServerResponse, transport: StreamableHTTPServerTransport): void {
-        const isMCPCall = getIsMCPCall(request.headers)
         const path = request.url
         const method = request.method
 
-        if (!isMCPCall || !path || getIsPathExcluded(path) || !method) {
+        if (!path || getIsPathExcluded(path) || !method) {
             return
         }
 
         const created = new Date()
 
-        let mcpRequestBody: MCPRequestBody | undefined
-        let mcpResponseBody: MCPResponseBody | undefined
+        let mcpRequestBody: any
+        let mcpResponseBody: any
 
         const originalTransportOnMessage = transport.onmessage
         transport.onmessage = (message, extra): void => {
-            mcpRequestBody = message as MCPRequestBody
+            mcpRequestBody = message
             originalTransportOnMessage?.(message, extra)
         }
     
         const originalTransportSend = transport.send
         transport.send = async (message, options): Promise<void> => {
-            mcpResponseBody = message as MCPResponseBody
+            mcpResponseBody = message
             await originalTransportSend.call(transport, message, options)
         }
 
@@ -166,6 +118,7 @@ export class KnownAgents {
             }
 
             const responseDurationInMilliseconds = Date.now() - created.getTime()
+            const mcpResponseResult = mcpResponseBody.result?.structuredContent ?? mcpResponseBody.result
 
             const visitRequest: VisitRequest = {
                 request_path: path,
@@ -181,10 +134,8 @@ export class KnownAgents {
                 mcp_response_result_is_error: mcpResponseBody.result?.isError,
                 mcp_response_error_code: mcpResponseBody.error?.code,
                 mcp_response_error_message: mcpResponseBody.error?.message,
-                acp_response_currency: getMCPACPCurrencyIfPossible(request, mcpResponseBody),
-                acp_response_total_amount: getMCPACPTotalAmountIfPossible(request, mcpResponseBody),
-                ucp_response_currency: getMCPUCPCurrencyIfPossible(request, mcpResponseBody),
-                ucp_response_total_amount: getMCPUCPTotalAmountIfPossible(request, mcpResponseBody),
+                acp_response_body: getIsACPCall(request.headers) ? mcpResponseResult : undefined,
+                ucp_response_body: getIsUCPCall(request.headers) ? mcpResponseResult : undefined,
                 created: created.toISOString()
             }
 

package/src/headers.ts

@@ -49,8 +49,8 @@ export function getIsUCPCall(headers: IncomingHttpHeaders): boolean {
     })
 }
 
-export function getIsProbablyACPCall(headers: IncomingHttpHeaders): boolean {
-    return Object.keys(headers).some((key) => {
+export function getIsACPCall(headers: IncomingHttpHeaders): boolean {
+    return !getIsUCPCall(headers) && Object.keys(headers).some((key) => {
         return key.toLowerCase() === "api-version"
     })
 }

package/src/index.ts

@@ -3,8 +3,6 @@ export {
     AgentType,
     type IdentificationRequest,
     type IdentificationResult,
-    type RESTACPResponseBody,
-    type RESTUCPResponseBody,
     type TrackPageviewOrRESTCallOptions,
     type VisitRequest
 } from "./types"

package/src/types.ts

@@ -1,39 +1,13 @@
 import type { IncomingHttpHeaders, OutgoingHttpHeaders } from "http"
 
-/**
- * ACP response details from a REST API call.
- */
-export interface RESTACPResponseBody {
-    /** The response currency, usually an ISO 4217 code. */
-    currency?: string
-    /** ACP totals returned by the REST endpoint. The "total" item is sent to Known Agents. */
-    totals?: {
-        type?: string
-        amount?: number
-    }[]
-}
-
-/**
- * UCP response details from a REST API call.
- */
-export interface RESTUCPResponseBody {
-    /** The response currency, usually an ISO 4217 code. */
-    currency?: string
-    /** UCP totals returned by the REST endpoint. The "total" item is sent to Known Agents. */
-    totals?: {
-        type?: string
-        amount?: number
-    }[]
-}
-
 /**
  * Additional metadata to include when tracking a pageview or REST API call.
  */
 export interface TrackPageviewOrRESTCallOptions {
-    /** ACP response body from the REST endpoint. */
-    restACPResponseBody?: RESTACPResponseBody
-    /** UCP response body from the REST endpoint. */
-    restUCPResponseBody?: RESTUCPResponseBody
+    /** The ACP response body. */
+    acpResponseBody?: Record<string, unknown>
+    /** The UCP response body. */
+    ucpResponseBody?: Record<string, unknown>
 }
 
 /**
@@ -67,14 +41,10 @@ export interface VisitRequest {
     mcp_response_error_code?: number
     /** The MCP response error message */
     mcp_response_error_message?: string
-    /** The ACP response currency */
-    acp_response_currency?: string
-    /** The ACP response "total" amount */
-    acp_response_total_amount?: number
-    /** The UCP response currency */
-    ucp_response_currency?: string
-    /** The UCP response "total" amount */
-    ucp_response_total_amount?: number
+    /** The ACP response body */
+    acp_response_body?: Record<string, unknown>
+    /** The UCP response body */
+    ucp_response_body?: Record<string, unknown>
     /** The timestamp when the visit occurred (ISO 8601 format) */
     created?: string
 }

package/src/commerce.ts

@@ -1,68 +0,0 @@
-import type { IncomingMessage } from "http"
-import { getIsProbablyACPCall, getIsUCPCall } from "./headers"
-import type { RESTACPResponseBody, RESTUCPResponseBody } from "./types"
-
-interface MCPCommerceResponseBody {
-    result?: {
-        currency?: string
-        totals?: {
-            type?: string
-            amount?: number
-        }[]
-        structuredContent?: {
-            currency?: string
-            totals?: {
-                type?: string
-                amount?: number
-            }[]
-        }
-    }
-}
-
-export function getRESTACPCurrencyIfPossible(restACPResponseBody: RESTACPResponseBody): string | undefined {
-    return restACPResponseBody?.currency
-}
-
-export function getRESTACPTotalAmountIfPossible(restACPResponseBody: RESTACPResponseBody): number | undefined {
-    return restACPResponseBody?.totals?.find((total) => {
-        return total.type == "total"
-    })?.amount
-}
-
-export function getMCPACPCurrencyIfPossible(request: IncomingMessage, mcpResponseBody: MCPCommerceResponseBody): string | undefined {
-    const isProbablyACP = !getIsUCPCall(request.headers) && getIsProbablyACPCall(request.headers)
-    return isProbablyACP ? mcpResponseBody.result?.currency : undefined
-}
-
-export function getMCPACPTotalAmountIfPossible(request: IncomingMessage, mcpResponseBody: MCPCommerceResponseBody): number | undefined {
-    const isProbablyACP = !getIsUCPCall(request.headers) && getIsProbablyACPCall(request.headers)
-    return isProbablyACP
-        ? mcpResponseBody.result?.totals?.find((total) => {
-              return total.type == "total"
-          })?.amount
-        : undefined
-}
-
-export function getRESTUCPCurrencyIfPossible(restUCPResponseBody: RESTUCPResponseBody): string | undefined {
-    return restUCPResponseBody?.currency
-}
-
-export function getRESTUCPTotalAmountIfPossible(restUCPResponseBody: RESTUCPResponseBody): number | undefined {
-    return restUCPResponseBody?.totals?.find((total) => {
-        return total.type == "total"
-    })?.amount
-}
-
-export function getMCPUCPCurrencyIfPossible(request: IncomingMessage, mcpResponseBody: MCPCommerceResponseBody): string | undefined {
-    const isUCP = getIsUCPCall(request.headers)
-    return isUCP ? mcpResponseBody.result?.structuredContent?.currency : undefined
-}
-
-export function getMCPUCPTotalAmountIfPossible(request: IncomingMessage, mcpResponseBody: MCPCommerceResponseBody): number | undefined {
-    const isUCP = getIsUCPCall(request.headers)
-    return isUCP
-        ? mcpResponseBody.result?.structuredContent?.totals?.find((total) => {
-              return total.type == "total"
-          })?.amount
-        : undefined
-}