@knownagents/sdk 3.0.0 → 3.1.0

package/README.md

@@ -72,8 +72,7 @@ const mcpHandler = createMcpHandler(({ requestInfo }) => {
         knownAgents.trackVisit(requestInfo, undefined, {
             mcp: {
                 context: context,
-                result: result,
-                toolName: "ping"
+                result: result
             }
         })
 
@@ -112,12 +111,12 @@ knownAgents.trackVisit(request, response, {
 
 Generate 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` method. 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"
 
-const robotsTxt = await knownAgents.generateRobotsTXT([
+const robotsTxt = await knownAgents.generateRobotsTxt([
     AgentType.AIDataScraper,
     AgentType.AIDataProvider,
     AgentType.Scraper,

package/dist/KnownAgents.d.ts

@@ -44,7 +44,7 @@ export declare class KnownAgents {
      * @returns A promise that resolves to the generated robots.txt content as a string.
      * @throws {Error} If the API call fails or returns a non-200 status.
      */
-    generateRobotsTXT(agentTypes: AgentType[], disallow?: string): Promise<string>;
+    generateRobotsTxt(agentTypes: AgentType[], disallow?: string): Promise<string>;
     /**
      * Identifies and verifies a single agent from an HTTP request.
      * Uses Web Bot Auth (HTTP message signatures), IP matching, or other available methods.

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;AAI3D,OAAO,KAAK,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EAEpB,MAAM,SAAS,CAAA;AAMhB;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAQ;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,mBAAmB,CAAmC;IAE9D;;;;;OAKG;gBACS,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAMjE;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,QAAQ,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAqDvH;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB;;;;;;;;;OASG;IACG,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBzF;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsB5E;;;;;;;OAOG;IACG,cAAc,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAuBxF,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;YAaP,UAAU;CAwB3B"}
+{"version":3,"file":"KnownAgents.d.ts","sourceRoot":"","sources":["../src/KnownAgents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,MAAM,CAAA;AAI3D,OAAO,KAAK,EACR,SAAS,EACT,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EAEpB,MAAM,SAAS,CAAA;AAMhB;;GAEG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAQ;IACpC,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAQ;IACpD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAQ;IACvC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,mBAAmB,CAAmC;IAE9D;;;;;OAKG;gBACS,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB;IAMjE;;;;;;;;OAQG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,QAAQ,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,IAAI;IAsDvH;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBtB;;;;;;;;;OASG;IACG,iBAAiB,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,QAAQ,GAAE,MAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBzF;;;;;;;OAOG;IACG,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAsB5E;;;;;;;OAOG;IACG,cAAc,CAAC,QAAQ,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,oBAAoB,EAAE,CAAC;IAuBxF,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,aAAa;YAaP,UAAU;CAwB3B"}

package/dist/KnownAgents.js

@@ -6,7 +6,7 @@ const headers_1 = require("./headers");
 const paths_1 = require("./paths");
 const DEFAULT_FLUSH_INTERVAL_IN_MILLISECONDS = 10000;
 const DEFAULT_FLUSH_QUEUE_SIZE = 1;
-const NODE_PACKAGE_VERSION = "3.0.0";
+const NODE_PACKAGE_VERSION = "3.1.0";
 /**
  * Server-side client for Known Agents analytics, robots.txt generation, and agent identification.
  */
@@ -35,10 +35,11 @@ class KnownAgents {
      */
     trackVisit(request, response, options) {
         const url = request instanceof Request ? new URL(request.url) : undefined;
-        const requestHeaders = request instanceof Request ? Object.fromEntries(request.headers.entries()) : request.headers;
+        const requestHeaders = request instanceof Request ? Object.fromEntries(request.headers) : request.headers;
+        const mcpRequestName = (0, headers_1.getHeaderValue)(requestHeaders, "mcp-name");
         const path = url ? `${url.pathname}${url.search}` : request.url;
         const method = request.method;
-        if (!path || (0, paths_1.getIsPathExcluded)(path) || !method) {
+        if (!path || (0, paths_1.isPathExcluded)(path) || !method) {
             return;
         }
         const created = new Date();
@@ -56,7 +57,7 @@ class KnownAgents {
                 response_headers: responseHeaders,
                 response_duration_in_milliseconds: responseDurationInMilliseconds,
                 mcp_request_method: mcp?.context?.mcpReq.method,
-                mcp_request_name: mcp?.toolName,
+                mcp_request_name: mcpRequestName,
                 mcp_request_client_info_name: clientInfo?.name,
                 mcp_request_client_info_version: clientInfo?.version,
                 mcp_response_result_is_error: mcp?.result?.isError,
@@ -107,7 +108,7 @@ class KnownAgents {
      * @returns A promise that resolves to the generated robots.txt content as a string.
      * @throws {Error} If the API call fails or returns a non-200 status.
      */
-    async generateRobotsTXT(agentTypes, disallow = "/") {
+    async generateRobotsTxt(agentTypes, disallow = "/") {
         const response = await fetch("https://api.knownagents.com/robots-txts", {
             method: "POST",
             headers: {
@@ -143,7 +144,7 @@ class KnownAgents {
                 "Content-Type": "application/json"
             },
             body: JSON.stringify({
-                request_headers: (0, headers_1.getFilteredHeaders)(request.headers),
+                request_headers: (0, headers_1.filterHeaders)(request.headers),
                 request_ip: request.socket.remoteAddress,
                 request_path: request.url,
                 node_package_version: NODE_PACKAGE_VERSION
@@ -174,7 +175,7 @@ class KnownAgents {
             body: JSON.stringify(requests.map((request) => {
                 return {
                     ...request,
-                    request_headers: (0, headers_1.getFilteredHeaders)(request.request_headers),
+                    request_headers: (0, headers_1.filterHeaders)(request.request_headers),
                     node_package_version: NODE_PACKAGE_VERSION
                 };
             }))
@@ -189,8 +190,8 @@ class KnownAgents {
     enqueueVisit(request) {
         this.visitQueue.push({
             ...request,
-            request_headers: (0, headers_1.getFilteredHeaders)(request.request_headers),
-            response_headers: request.response_headers ? (0, headers_1.getFilteredHeaders)(request.response_headers) : undefined,
+            request_headers: (0, headers_1.filterHeaders)(request.request_headers),
+            response_headers: request.response_headers ? (0, headers_1.filterHeaders)(request.response_headers) : undefined,
         });
         if (this.visitQueue.length >= this.flushQueueSize) {
             void this.flush();

package/dist/headers.d.ts

@@ -1,3 +1,4 @@
 import type { IncomingHttpHeaders, OutgoingHttpHeaders } from "http";
-export declare function getFilteredHeaders<Headers extends IncomingHttpHeaders | OutgoingHttpHeaders>(headers: Headers): Headers;
+export declare function getHeaderValue(headers: IncomingHttpHeaders | OutgoingHttpHeaders, headerName: string): string | undefined;
+export declare function filterHeaders<Headers extends IncomingHttpHeaders | OutgoingHttpHeaders>(headers: Headers): Headers;
 //# 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"}
+{"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,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBzH;AAED,wBAAgB,aAAa,CAAC,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAUlH"}

package/dist/headers.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFilteredHeaders = getFilteredHeaders;
+exports.getHeaderValue = getHeaderValue;
+exports.filterHeaders = filterHeaders;
 const filteredHeaderNames = [
     "authorization",
     "proxy-authorization",
@@ -25,7 +26,21 @@ const filteredHeaderNames = [
     "client-secret",
     "private-token"
 ];
-function getFilteredHeaders(headers) {
+function getHeaderValue(headers, headerName) {
+    const normalizedHeaderName = headerName.toLowerCase();
+    const matchingHeaderName = Object.keys(headers).find((candidate) => {
+        return candidate.toLowerCase() === normalizedHeaderName;
+    });
+    if (!matchingHeaderName) {
+        return undefined;
+    }
+    const headerValue = headers[matchingHeaderName];
+    if (Array.isArray(headerValue)) {
+        return headerValue[0];
+    }
+    return headerValue?.toString();
+}
+function filterHeaders(headers) {
     const filteredHeaders = { ...headers };
     Object.keys(filteredHeaders).forEach((key) => {
         if (filteredHeaderNames.includes(key.toLowerCase())) {

package/dist/paths.d.ts

@@ -1,2 +1,2 @@
-export declare function getIsPathExcluded(path: string): boolean;
+export declare function isPathExcluded(path: string): boolean;
 //# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuEvD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAuEpD"}

package/dist/paths.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getIsPathExcluded = getIsPathExcluded;
-function getIsPathExcluded(path) {
+exports.isPathExcluded = isPathExcluded;
+function isPathExcluded(path) {
     const pathWithoutQueryString = path.split(/[?#]/)[0];
     const lowercasedPath = pathWithoutQueryString.toLowerCase();
     const excludedPrefixes = [

package/dist/types.d.ts

@@ -17,7 +17,6 @@ export interface TrackVisitOptions {
     mcp?: {
         context?: ServerContext;
         result?: CallToolResult;
-        toolName?: string;
     };
     acp?: {
         responseBody: Record<string, unknown>;

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":"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"}

package/package.json

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

package/src/KnownAgents.ts

@@ -1,7 +1,7 @@
 import type { IncomingMessage, ServerResponse } from "http"
 import { CLIENT_INFO_META_KEY, type Implementation } from "@modelcontextprotocol/server"
-import { getFilteredHeaders } from "./headers"
-import { getIsPathExcluded } from "./paths"
+import { filterHeaders, getHeaderValue } from "./headers"
+import { isPathExcluded } from "./paths"
 import type {
     AgentType,
     IdentificationRequest,
@@ -13,7 +13,7 @@ import type {
 
 const DEFAULT_FLUSH_INTERVAL_IN_MILLISECONDS = 10000
 const DEFAULT_FLUSH_QUEUE_SIZE = 1
-const NODE_PACKAGE_VERSION = "3.0.0"
+const NODE_PACKAGE_VERSION = "3.1.0"
 
 /**
  * Server-side client for Known Agents analytics, robots.txt generation, and agent identification.
@@ -49,11 +49,12 @@ export class KnownAgents {
      */
     trackVisit(request: IncomingMessage | Request, response?: ServerResponse | Response, options?: TrackVisitOptions): void {
         const url = request instanceof Request ? new URL(request.url) : undefined
-        const requestHeaders = request instanceof Request ? Object.fromEntries(request.headers.entries()) : request.headers
+        const requestHeaders = request instanceof Request ? Object.fromEntries(request.headers) : request.headers
+        const mcpRequestName = getHeaderValue(requestHeaders, "mcp-name")
         const path = url ? `${url.pathname}${url.search}` : request.url
         const method = request.method
 
-        if (!path || getIsPathExcluded(path) || !method) {
+        if (!path || isPathExcluded(path) || !method) {
             return
         }
 
@@ -76,7 +77,7 @@ export class KnownAgents {
                 response_headers: responseHeaders,
                 response_duration_in_milliseconds: responseDurationInMilliseconds,
                 mcp_request_method: mcp?.context?.mcpReq.method,
-                mcp_request_name: mcp?.toolName,
+                mcp_request_name: mcpRequestName,
                 mcp_request_client_info_name: clientInfo?.name,
                 mcp_request_client_info_version: clientInfo?.version,
                 mcp_response_result_is_error: mcp?.result?.isError,
@@ -135,7 +136,7 @@ export class KnownAgents {
      * @returns A promise that resolves to the generated robots.txt content as a string.
      * @throws {Error} If the API call fails or returns a non-200 status.
      */
-    async generateRobotsTXT(agentTypes: AgentType[], disallow: string = "/"): Promise<string> {
+    async generateRobotsTxt(agentTypes: AgentType[], disallow: string = "/"): Promise<string> {
         const response = await fetch("https://api.knownagents.com/robots-txts", {
             method: "POST",
             headers: {
@@ -172,7 +173,7 @@ export class KnownAgents {
                 "Content-Type": "application/json"
             },
             body: JSON.stringify({
-                request_headers: getFilteredHeaders(request.headers),
+                request_headers: filterHeaders(request.headers),
                 request_ip: request.socket.remoteAddress,
                 request_path: request.url,
                 node_package_version: NODE_PACKAGE_VERSION
@@ -204,7 +205,7 @@ export class KnownAgents {
             body: JSON.stringify(requests.map((request) => {
                 return {
                     ...request,
-                    request_headers: getFilteredHeaders(request.request_headers),
+                    request_headers: filterHeaders(request.request_headers),
                     node_package_version: NODE_PACKAGE_VERSION
                 }
             }))
@@ -220,8 +221,8 @@ export class KnownAgents {
     private enqueueVisit(request: VisitRequest): void {
         this.visitQueue.push({
             ...request,
-            request_headers: getFilteredHeaders(request.request_headers),
-            response_headers: request.response_headers ? getFilteredHeaders(request.response_headers) : undefined,
+            request_headers: filterHeaders(request.request_headers),
+            response_headers: request.response_headers ? filterHeaders(request.response_headers) : undefined,
         })
 
         if (this.visitQueue.length >= this.flushQueueSize) {

package/src/headers.ts

@@ -25,7 +25,26 @@ const filteredHeaderNames = [
     "private-token"
 ]
 
-export function getFilteredHeaders<Headers extends IncomingHttpHeaders | OutgoingHttpHeaders>(headers: Headers): Headers {
+export function getHeaderValue(headers: IncomingHttpHeaders | OutgoingHttpHeaders, headerName: string): string | undefined {
+    const normalizedHeaderName = headerName.toLowerCase()
+    const matchingHeaderName = Object.keys(headers).find((candidate) => {
+        return candidate.toLowerCase() === normalizedHeaderName
+    })
+
+    if (!matchingHeaderName) {
+        return undefined
+    }
+
+    const headerValue = headers[matchingHeaderName]
+
+    if (Array.isArray(headerValue)) {
+        return headerValue[0]
+    }
+
+    return headerValue?.toString()
+}
+
+export function filterHeaders<Headers extends IncomingHttpHeaders | OutgoingHttpHeaders>(headers: Headers): Headers {
     const filteredHeaders = { ...headers }
 
     Object.keys(filteredHeaders).forEach((key) => {

package/src/paths.ts

@@ -1,4 +1,4 @@
-export function getIsPathExcluded(path: string): boolean {
+export function isPathExcluded(path: string): boolean {
     const pathWithoutQueryString = path.split(/[?#]/)[0]
     const lowercasedPath = pathWithoutQueryString.toLowerCase()
 

package/src/types.ts

@@ -19,7 +19,6 @@ export interface TrackVisitOptions {
     mcp?: {
         context?: ServerContext
         result?: CallToolResult
-        toolName?: string
     }
     acp?: {
         responseBody: Record<string, unknown>