@agentcash/telemetry 0.3.0

package/dist/chunk-P63MLKU3.js

@@ -0,0 +1,60 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/clickhouse.ts
+var _client = require('@clickhouse/client');
+var clickhouseClient = null;
+var TABLE = "mcp_resource_invocations";
+function initClickhouse(config) {
+  clickhouseClient = _client.createClient.call(void 0, {
+    url: config.url,
+    database: _nullishCoalesce(config.database, () => ( "default")),
+    username: _nullishCoalesce(config.username, () => ( "default")),
+    password: _nullishCoalesce(config.password, () => ( ""))
+  });
+}
+function pingClickhouse() {
+  if (!clickhouseClient) {
+    console.error("[telemetry] Cannot verify: ClickHouse client not initialized.");
+    return;
+  }
+  clickhouseClient.ping().then((result) => {
+    if (result.success) {
+      console.log("[telemetry] ClickHouse connected");
+    } else {
+      console.error("[telemetry] ClickHouse ping failed");
+    }
+  }).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error("[telemetry] ClickHouse ping failed:", message);
+  });
+}
+function insertInvocation(data) {
+  try {
+    if (!clickhouseClient) {
+      console.error("[telemetry] ClickHouse client not initialized. Call initTelemetry() first.");
+      return;
+    }
+    clickhouseClient.insert({
+      table: TABLE,
+      values: [data],
+      format: "JSONEachRow"
+    }).catch((error) => {
+      try {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error("[telemetry] ClickHouse insert failed:", message);
+      } catch (e) {
+      }
+    });
+  } catch (error) {
+    try {
+      const message = error instanceof Error ? error.message : String(error);
+      console.error("[telemetry] ClickHouse insert threw synchronously:", message);
+    } catch (e2) {
+    }
+  }
+}
+
+
+
+
+
+exports.initClickhouse = initClickhouse; exports.pingClickhouse = pingClickhouse; exports.insertInvocation = insertInvocation;
+//# sourceMappingURL=chunk-P63MLKU3.js.map

package/dist/chunk-P63MLKU3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/samragsdale/Documents/Code/merit-systems/agentcash-telemetry/dist/chunk-P63MLKU3.js","../src/clickhouse.ts"],"names":[],"mappings":"AAAA;ACAA,4CAA6B;AAG7B,IAAI,iBAAA,EAA2D,IAAA;AAE/D,IAAM,MAAA,EAAQ,0BAAA;AAMP,SAAS,cAAA,CAAe,MAAA,EAA6C;AAC1E,EAAA,iBAAA,EAAmB,kCAAA;AAAa,IAC9B,GAAA,EAAK,MAAA,CAAO,GAAA;AAAA,IACZ,QAAA,mBAAU,MAAA,CAAO,QAAA,UAAY,WAAA;AAAA,IAC7B,QAAA,mBAAU,MAAA,CAAO,QAAA,UAAY,WAAA;AAAA,IAC7B,QAAA,mBAAU,MAAA,CAAO,QAAA,UAAY;AAAA,EAC/B,CAAC,CAAA;AACH;AAKO,SAAS,cAAA,CAAA,EAAuB;AACrC,EAAA,GAAA,CAAI,CAAC,gBAAA,EAAkB;AACrB,IAAA,OAAA,CAAQ,KAAA,CAAM,+DAA+D,CAAA;AAC7E,IAAA,MAAA;AAAA,EACF;AACA,EAAA,gBAAA,CACG,IAAA,CAAK,CAAA,CACL,IAAA,CAAK,CAAC,MAAA,EAAA,GAAW;AAChB,IAAA,GAAA,CAAI,MAAA,CAAO,OAAA,EAAS;AAClB,MAAA,OAAA,CAAQ,GAAA,CAAI,kCAAkC,CAAA;AAAA,IAChD,EAAA,KAAO;AACL,MAAA,OAAA,CAAQ,KAAA,CAAM,oCAAoC,CAAA;AAAA,IACpD;AAAA,EACF,CAAC,CAAA,CACA,KAAA,CAAM,CAAC,KAAA,EAAA,GAAmB;AACzB,IAAA,MAAM,QAAA,EAAU,MAAA,WAAiB,MAAA,EAAQ,KAAA,CAAM,QAAA,EAAU,MAAA,CAAO,KAAK,CAAA;AACrE,IAAA,OAAA,CAAQ,KAAA,CAAM,qCAAA,EAAuC,OAAO,CAAA;AAAA,EAC9D,CAAC,CAAA;AACL;AAMO,SAAS,gBAAA,CAAiB,IAAA,EAAmC;AAClE,EAAA,IAAI;AACF,IAAA,GAAA,CAAI,CAAC,gBAAA,EAAkB;AACrB,MAAA,OAAA,CAAQ,KAAA,CAAM,4EAA4E,CAAA;AAC1F,MAAA,MAAA;AAAA,IACF;AAGA,IAAA,gBAAA,CACG,MAAA,CAA8B;AAAA,MAC7B,KAAA,EAAO,KAAA;AAAA,MACP,MAAA,EAAQ,CAAC,IAAI,CAAA;AAAA,MACb,MAAA,EAAQ;AAAA,IACV,CAAC,CAAA,CACA,KAAA,CAAM,CAAC,KAAA,EAAA,GAAmB;AACzB,MAAA,IAAI;AACF,QAAA,MAAM,QAAA,EAAU,MAAA,WAAiB,MAAA,EAAQ,KAAA,CAAM,QAAA,EAAU,MAAA,CAAO,KAAK,CAAA;AACrE,QAAA,OAAA,CAAQ,KAAA,CAAM,uCAAA,EAAyC,OAAO,CAAA;AAAA,MAChE,EAAA,UAAQ;AAAA,MAER;AAAA,IACF,CAAC,CAAA;AAAA,EACL,EAAA,MAAA,CAAS,KAAA,EAAgB;AACvB,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,EAAU,MAAA,WAAiB,MAAA,EAAQ,KAAA,CAAM,QAAA,EAAU,MAAA,CAAO,KAAK,CAAA;AACrE,MAAA,OAAA,CAAQ,KAAA,CAAM,oDAAA,EAAsD,OAAO,CAAA;AAAA,IAC7E,EAAA,WAAQ;AAAA,IAER;AAAA,EACF;AACF;ADxBA;AACA;AACE;AACA;AACA;AACF,8HAAC","file":"/Users/samragsdale/Documents/Code/merit-systems/agentcash-telemetry/dist/chunk-P63MLKU3.js","sourcesContent":[null,"import { createClient } from '@clickhouse/client';\nimport type { McpResourceInvocation, TelemetryConfig } from './types';\n\nlet clickhouseClient: ReturnType<typeof createClient> | null = null;\n\nconst TABLE = 'mcp_resource_invocations';\n\n/**\n * Initialize the ClickHouse client singleton.\n * createClient() is synchronous — no async needed.\n */\nexport function initClickhouse(config: TelemetryConfig['clickhouse']): void {\n  clickhouseClient = createClient({\n    url: config.url,\n    database: config.database ?? 'default',\n    username: config.username ?? 'default',\n    password: config.password ?? '',\n  });\n}\n\n/**\n * Ping ClickHouse to verify the connection. Fire-and-forget, logs result.\n */\nexport function pingClickhouse(): void {\n  if (!clickhouseClient) {\n    console.error('[telemetry] Cannot verify: ClickHouse client not initialized.');\n    return;\n  }\n  clickhouseClient\n    .ping()\n    .then((result) => {\n      if (result.success) {\n        console.log('[telemetry] ClickHouse connected');\n      } else {\n        console.error('[telemetry] ClickHouse ping failed');\n      }\n    })\n    .catch((error: unknown) => {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error('[telemetry] ClickHouse ping failed:', message);\n    });\n}\n\n/**\n * Fire-and-forget insert into mcp_resource_invocations.\n * Wrapped in try/catch — never throws, never blocks.\n */\nexport function insertInvocation(data: McpResourceInvocation): void {\n  try {\n    if (!clickhouseClient) {\n      console.error('[telemetry] ClickHouse client not initialized. Call initTelemetry() first.');\n      return;\n    }\n\n    // Fire and forget — do NOT await\n    clickhouseClient\n      .insert<McpResourceInvocation>({\n        table: TABLE,\n        values: [data],\n        format: 'JSONEachRow',\n      })\n      .catch((error: unknown) => {\n        try {\n          const message = error instanceof Error ? error.message : String(error);\n          console.error('[telemetry] ClickHouse insert failed:', message);\n        } catch {\n          // Absolutely nothing escapes\n        }\n      });\n  } catch (error: unknown) {\n    try {\n      const message = error instanceof Error ? error.message : String(error);\n      console.error('[telemetry] ClickHouse insert threw synchronously:', message);\n    } catch {\n      // Absolutely nothing escapes\n    }\n  }\n}\n"]}

package/dist/chunk-VOY67KA4.mjs

@@ -0,0 +1,149 @@
+import {
+  initClickhouse,
+  insertInvocation,
+  pingClickhouse
+} from "./chunk-O2PCP6KV.mjs";
+
+// src/init.ts
+var configuredOrigin;
+function initTelemetry(config) {
+  initClickhouse(config.clickhouse);
+  if (config.origin) {
+    configuredOrigin = config.origin;
+  }
+  if (config.verify) {
+    pingClickhouse();
+  }
+}
+function getOrigin() {
+  return configuredOrigin;
+}
+
+// src/extract-wallet.ts
+function extractVerifiedWallet(headers) {
+  try {
+    const payerAddress = headers.get("x-payer-address");
+    if (payerAddress) {
+      return payerAddress.toLowerCase();
+    }
+    const paymentHeader = headers.get("PAYMENT-SIGNATURE") ?? headers.get("payment-signature") ?? headers.get("X-PAYMENT") ?? headers.get("x-payment");
+    if (!paymentHeader) return null;
+    try {
+      const decoded = JSON.parse(Buffer.from(paymentHeader, "base64").toString());
+      const from = decoded?.payload?.authorization?.from ?? decoded?.payload?.from;
+      return typeof from === "string" ? from.toLowerCase() : null;
+    } catch {
+      return null;
+    }
+  } catch {
+    return null;
+  }
+}
+
+// src/telemetry-core.ts
+import { randomUUID } from "crypto";
+function extractRequestMeta(request) {
+  const meta = {
+    requestId: randomUUID(),
+    startTime: Date.now(),
+    walletAddress: null,
+    clientId: null,
+    sessionId: null,
+    verifiedWallet: null,
+    route: "",
+    method: "",
+    origin: "",
+    referer: null,
+    requestContentType: null,
+    requestHeadersJson: null
+  };
+  try {
+    meta.walletAddress = request.headers.get("X-Wallet-Address")?.toLowerCase() ?? null;
+    meta.clientId = request.headers.get("X-Client-ID") ?? null;
+    meta.sessionId = request.headers.get("X-Session-ID") ?? null;
+    meta.referer = request.headers.get("Referer") ?? null;
+    meta.requestContentType = request.headers.get("content-type") ?? null;
+    meta.route = request.nextUrl.pathname;
+    meta.method = request.method;
+    meta.origin = getOrigin() ?? request.nextUrl.origin;
+    meta.verifiedWallet = extractVerifiedWallet(request.headers);
+    meta.requestHeadersJson = JSON.stringify(Object.fromEntries(request.headers.entries()));
+  } catch {
+  }
+  return meta;
+}
+function buildTelemetryContext(meta) {
+  const ctx = {
+    walletAddress: meta.walletAddress,
+    clientId: meta.clientId,
+    sessionId: meta.sessionId,
+    verifiedWallet: meta.verifiedWallet,
+    setVerifiedWallet: (address) => {
+      meta.verifiedWallet = address.toLowerCase();
+      ctx.verifiedWallet = meta.verifiedWallet;
+    }
+  };
+  return ctx;
+}
+function recordInvocation(meta, requestBody, response) {
+  try {
+    const invocation = {
+      id: meta.requestId,
+      x_wallet_address: meta.walletAddress,
+      x_client_id: meta.clientId,
+      session_id: meta.sessionId,
+      verified_wallet_address: meta.verifiedWallet,
+      method: meta.method,
+      route: meta.route,
+      origin: meta.origin,
+      referer: meta.referer,
+      request_content_type: meta.requestContentType,
+      request_headers: meta.requestHeadersJson,
+      request_body: requestBody,
+      status_code: response.status,
+      status_text: statusTextFromCode(response.status),
+      duration: Date.now() - meta.startTime,
+      response_content_type: response.contentType,
+      response_headers: response.headers,
+      response_body: response.body,
+      created_at: /* @__PURE__ */ new Date()
+    };
+    insertInvocation(invocation);
+  } catch {
+  }
+}
+function statusTextFromCode(code) {
+  switch (code) {
+    case 200:
+      return "OK";
+    case 201:
+      return "Created";
+    case 204:
+      return "No Content";
+    case 400:
+      return "Bad Request";
+    case 401:
+      return "Unauthorized";
+    case 402:
+      return "Payment Required";
+    case 403:
+      return "Forbidden";
+    case 404:
+      return "Not Found";
+    case 500:
+      return "Internal Server Error";
+    case 504:
+      return "Gateway Timeout";
+    default:
+      return String(code);
+  }
+}
+
+export {
+  initTelemetry,
+  extractVerifiedWallet,
+  extractRequestMeta,
+  buildTelemetryContext,
+  recordInvocation
+};
+//# sourceMappingURL=chunk-VOY67KA4.mjs.map

package/dist/chunk-VOY67KA4.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/init.ts","../src/extract-wallet.ts","../src/telemetry-core.ts"],"sourcesContent":["import type { TelemetryConfig } from './types';\nimport { initClickhouse, pingClickhouse } from './clickhouse';\n\nlet configuredOrigin: string | undefined;\n\n/**\n * Initialize the telemetry package. Call once at module level.\n *\n * This is synchronous — createClient() does not connect until first query.\n *\n * IMPORTANT: On Vercel, instrumentation.ts runs in a separate module scope\n * from route handlers. Call this in the same module that imports your route\n * wrappers (withTelemetry, createRouteBuilder, etc.), NOT in instrumentation.ts.\n *\n * ```typescript\n * import { initTelemetry, withTelemetry } from '@agentcash/telemetry';\n *\n * initTelemetry({\n *   clickhouse: {\n *     url: process.env.TELEM_CLICKHOUSE_URL!,\n *     database: process.env.TELEM_CLICKHOUSE_DATABASE,\n *     username: process.env.TELEM_CLICKHOUSE_USERNAME,\n *     password: process.env.TELEM_CLICKHOUSE_PASSWORD,\n *   },\n * });\n * ```\n */\nexport function initTelemetry(config: TelemetryConfig): void {\n  initClickhouse(config.clickhouse);\n  if (config.origin) {\n    configuredOrigin = config.origin;\n  }\n  if (config.verify) {\n    pingClickhouse();\n  }\n}\n\n/** Get the configured origin, or undefined if not set. */\nexport function getOrigin(): string | undefined {\n  return configuredOrigin;\n}\n","/**\n * Extract verified wallet address from x402 payment headers.\n *\n * Checks multiple sources in priority order:\n * 1. x-payer-address — injected by @x402/next's withX402 after verification (highest confidence)\n * 2. PAYMENT-SIGNATURE / X-PAYMENT — decode the payment header directly\n *\n * If the handler is executing, withX402 has already verified the payment signature.\n * For manual x402 flows, the app verifies before calling business logic.\n * Either way, the header content is trustworthy when this runs.\n */\nexport function extractVerifiedWallet(headers: Headers): string | null {\n  try {\n    // 1. x-payer-address: injected by @x402/next's withX402 after verification\n    const payerAddress = headers.get('x-payer-address');\n    if (payerAddress) {\n      return payerAddress.toLowerCase();\n    }\n\n    // 2. Decode from PAYMENT-SIGNATURE or X-PAYMENT header\n    const paymentHeader =\n      headers.get('PAYMENT-SIGNATURE') ??\n      headers.get('payment-signature') ??\n      headers.get('X-PAYMENT') ??\n      headers.get('x-payment');\n\n    if (!paymentHeader) return null;\n\n    // Decode the base64 payment header to extract the payer address.\n    // The header is a base64-encoded JSON object with the structure:\n    // { payload: { authorization: { from: \"0x...\" }, signature: \"0x...\" } }\n    try {\n      const decoded = JSON.parse(Buffer.from(paymentHeader, 'base64').toString()) as {\n        payload?: { authorization?: { from?: string }; from?: string };\n      };\n      const from = decoded?.payload?.authorization?.from ?? decoded?.payload?.from;\n      return typeof from === 'string' ? from.toLowerCase() : null;\n    } catch {\n      return null;\n    }\n  } catch {\n    return null;\n  }\n}\n","/**\n * Shared telemetry primitives used by withTelemetry and the route builder.\n * Extracts request metadata, builds telemetry context, and records invocations.\n */\n\nimport { type NextRequest } from 'next/server';\nimport { randomUUID } from 'crypto';\nimport type { TelemetryContext, McpResourceInvocation, RequestMeta } from './types';\nimport { insertInvocation } from './clickhouse';\nimport { extractVerifiedWallet } from './extract-wallet';\nimport { getOrigin } from './init';\n\n/**\n * Extract identity headers, route info, and verified wallet from a request.\n * All wrapped in try/catch — returns safe defaults on failure.\n */\nexport function extractRequestMeta(request: NextRequest): RequestMeta {\n  const meta: RequestMeta = {\n    requestId: randomUUID(),\n    startTime: Date.now(),\n    walletAddress: null,\n    clientId: null,\n    sessionId: null,\n    verifiedWallet: null,\n    route: '',\n    method: '',\n    origin: '',\n    referer: null,\n    requestContentType: null,\n    requestHeadersJson: null,\n  };\n\n  try {\n    meta.walletAddress = request.headers.get('X-Wallet-Address')?.toLowerCase() ?? null;\n    meta.clientId = request.headers.get('X-Client-ID') ?? null;\n    meta.sessionId = request.headers.get('X-Session-ID') ?? null;\n    meta.referer = request.headers.get('Referer') ?? null;\n    meta.requestContentType = request.headers.get('content-type') ?? null;\n    meta.route = request.nextUrl.pathname;\n    meta.method = request.method;\n    meta.origin = getOrigin() ?? request.nextUrl.origin;\n    meta.verifiedWallet = extractVerifiedWallet(request.headers);\n    meta.requestHeadersJson = JSON.stringify(Object.fromEntries(request.headers.entries()));\n  } catch {\n    // Header extraction failed — continue with defaults\n  }\n\n  return meta;\n}\n\n/**\n * Build a TelemetryContext from extracted request metadata.\n * setVerifiedWallet mutates meta.verifiedWallet so recordInvocation sees the update.\n */\nexport function buildTelemetryContext(meta: RequestMeta): TelemetryContext {\n  const ctx: TelemetryContext = {\n    walletAddress: meta.walletAddress,\n    clientId: meta.clientId,\n    sessionId: meta.sessionId,\n    verifiedWallet: meta.verifiedWallet,\n    setVerifiedWallet: (address: string) => {\n      meta.verifiedWallet = address.toLowerCase();\n      ctx.verifiedWallet = meta.verifiedWallet;\n    },\n  };\n  return ctx;\n}\n\n/**\n * Record an invocation to ClickHouse. Fire-and-forget, fully wrapped in try/catch.\n */\nexport function recordInvocation(\n  meta: RequestMeta,\n  requestBody: string | null,\n  response: {\n    status: number;\n    body: string | null;\n    headers: string | null;\n    contentType: string | null;\n  },\n): void {\n  try {\n    const invocation: McpResourceInvocation = {\n      id: meta.requestId,\n      x_wallet_address: meta.walletAddress,\n      x_client_id: meta.clientId,\n      session_id: meta.sessionId,\n      verified_wallet_address: meta.verifiedWallet,\n      method: meta.method,\n      route: meta.route,\n      origin: meta.origin,\n      referer: meta.referer,\n      request_content_type: meta.requestContentType,\n      request_headers: meta.requestHeadersJson,\n      request_body: requestBody,\n      status_code: response.status,\n      status_text: statusTextFromCode(response.status),\n      duration: Date.now() - meta.startTime,\n      response_content_type: response.contentType,\n      response_headers: response.headers,\n      response_body: response.body,\n      created_at: new Date(),\n    };\n    insertInvocation(invocation);\n  } catch {\n    // Never affects the response\n  }\n}\n\nfunction statusTextFromCode(code: number): string {\n  switch (code) {\n    case 200:\n      return 'OK';\n    case 201:\n      return 'Created';\n    case 204:\n      return 'No Content';\n    case 400:\n      return 'Bad Request';\n    case 401:\n      return 'Unauthorized';\n    case 402:\n      return 'Payment Required';\n    case 403:\n      return 'Forbidden';\n    case 404:\n      return 'Not Found';\n    case 500:\n      return 'Internal Server Error';\n    case 504:\n      return 'Gateway Timeout';\n    default:\n      return String(code);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,59 @@
+import { T as TelemetryConfig, a as TelemetryContext } from './types-Bl8IwXin.mjs';
+export { M as McpResourceInvocation } from './types-Bl8IwXin.mjs';
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * Initialize the telemetry package. Call once at module level.
+ *
+ * This is synchronous — createClient() does not connect until first query.
+ *
+ * IMPORTANT: On Vercel, instrumentation.ts runs in a separate module scope
+ * from route handlers. Call this in the same module that imports your route
+ * wrappers (withTelemetry, createRouteBuilder, etc.), NOT in instrumentation.ts.
+ *
+ * ```typescript
+ * import { initTelemetry, withTelemetry } from '@agentcash/telemetry';
+ *
+ * initTelemetry({
+ *   clickhouse: {
+ *     url: process.env.TELEM_CLICKHOUSE_URL!,
+ *     database: process.env.TELEM_CLICKHOUSE_DATABASE,
+ *     username: process.env.TELEM_CLICKHOUSE_USERNAME,
+ *     password: process.env.TELEM_CLICKHOUSE_PASSWORD,
+ *   },
+ * });
+ * ```
+ */
+declare function initTelemetry(config: TelemetryConfig): void;
+
+/**
+ * Core telemetry wrapper for Next.js route handlers.
+ * Extracts identity headers, logs to ClickHouse, extracts verified wallet.
+ * This is a passive observer — it never influences the response.
+ */
+
+type TelemetryHandler = (request: NextRequest, ctx: TelemetryContext) => Promise<NextResponse>;
+/**
+ * Wrap a Next.js route handler with telemetry.
+ * Extracts identity headers, logs the invocation to ClickHouse,
+ * and auto-extracts verified wallet from x402 payment headers.
+ *
+ * The entire telemetry code path is wrapped in try/catch.
+ * Telemetry failures never affect the response.
+ */
+declare function withTelemetry(handler: TelemetryHandler): (request: NextRequest) => Promise<NextResponse>;
+
+/**
+ * Extract verified wallet address from x402 payment headers.
+ *
+ * Checks multiple sources in priority order:
+ * 1. x-payer-address — injected by @x402/next's withX402 after verification (highest confidence)
+ * 2. PAYMENT-SIGNATURE / X-PAYMENT — decode the payment header directly
+ *
+ * If the handler is executing, withX402 has already verified the payment signature.
+ * For manual x402 flows, the app verifies before calling business logic.
+ * Either way, the header content is trustworthy when this runs.
+ */
+declare function extractVerifiedWallet(headers: Headers): string | null;
+
+export { TelemetryConfig, TelemetryContext, extractVerifiedWallet, initTelemetry, withTelemetry };

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+import { T as TelemetryConfig, a as TelemetryContext } from './types-Bl8IwXin.js';
+export { M as McpResourceInvocation } from './types-Bl8IwXin.js';
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * Initialize the telemetry package. Call once at module level.
+ *
+ * This is synchronous — createClient() does not connect until first query.
+ *
+ * IMPORTANT: On Vercel, instrumentation.ts runs in a separate module scope
+ * from route handlers. Call this in the same module that imports your route
+ * wrappers (withTelemetry, createRouteBuilder, etc.), NOT in instrumentation.ts.
+ *
+ * ```typescript
+ * import { initTelemetry, withTelemetry } from '@agentcash/telemetry';
+ *
+ * initTelemetry({
+ *   clickhouse: {
+ *     url: process.env.TELEM_CLICKHOUSE_URL!,
+ *     database: process.env.TELEM_CLICKHOUSE_DATABASE,
+ *     username: process.env.TELEM_CLICKHOUSE_USERNAME,
+ *     password: process.env.TELEM_CLICKHOUSE_PASSWORD,
+ *   },
+ * });
+ * ```
+ */
+declare function initTelemetry(config: TelemetryConfig): void;
+
+/**
+ * Core telemetry wrapper for Next.js route handlers.
+ * Extracts identity headers, logs to ClickHouse, extracts verified wallet.
+ * This is a passive observer — it never influences the response.
+ */
+
+type TelemetryHandler = (request: NextRequest, ctx: TelemetryContext) => Promise<NextResponse>;
+/**
+ * Wrap a Next.js route handler with telemetry.
+ * Extracts identity headers, logs the invocation to ClickHouse,
+ * and auto-extracts verified wallet from x402 payment headers.
+ *
+ * The entire telemetry code path is wrapped in try/catch.
+ * Telemetry failures never affect the response.
+ */
+declare function withTelemetry(handler: TelemetryHandler): (request: NextRequest) => Promise<NextResponse>;
+
+/**
+ * Extract verified wallet address from x402 payment headers.
+ *
+ * Checks multiple sources in priority order:
+ * 1. x-payer-address — injected by @x402/next's withX402 after verification (highest confidence)
+ * 2. PAYMENT-SIGNATURE / X-PAYMENT — decode the payment header directly
+ *
+ * If the handler is executing, withX402 has already verified the payment signature.
+ * For manual x402 flows, the app verifies before calling business logic.
+ * Either way, the header content is trustworthy when this runs.
+ */
+declare function extractVerifiedWallet(headers: Headers): string | null;
+
+export { TelemetryConfig, TelemetryContext, extractVerifiedWallet, initTelemetry, withTelemetry };

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkFJ3YM6KOjs = require('./chunk-FJ3YM6KO.js');
+
+
+
+var _chunkGE7VBMQPjs = require('./chunk-GE7VBMQP.js');
+require('./chunk-P63MLKU3.js');
+
+
+
+
+exports.extractVerifiedWallet = _chunkGE7VBMQPjs.extractVerifiedWallet; exports.initTelemetry = _chunkGE7VBMQPjs.initTelemetry; exports.withTelemetry = _chunkFJ3YM6KOjs.withTelemetry;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["/Users/samragsdale/Documents/Code/merit-systems/agentcash-telemetry/dist/index.js"],"names":[],"mappings":"AAAA;AACE;AACF,sDAA4B;AAC5B;AACE;AACA;AACF,sDAA4B;AAC5B,+BAA4B;AAC5B;AACE;AACA;AACA;AACF,uLAAC","file":"/Users/samragsdale/Documents/Code/merit-systems/agentcash-telemetry/dist/index.js"}

package/dist/index.mjs

@@ -0,0 +1,14 @@
+import {
+  withTelemetry
+} from "./chunk-JVLKV7CX.mjs";
+import {
+  extractVerifiedWallet,
+  initTelemetry
+} from "./chunk-VOY67KA4.mjs";
+import "./chunk-O2PCP6KV.mjs";
+export {
+  extractVerifiedWallet,
+  initTelemetry,
+  withTelemetry
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/router-plugin.d.mts

@@ -0,0 +1,109 @@
+import { T as TelemetryConfig } from './types-Bl8IwXin.mjs';
+
+/**
+ * RouterPlugin adapter for @agentcash/router.
+ *
+ * Bridges the router's plugin hooks into ClickHouse telemetry.
+ * Uses the same mcp_resource_invocations table as the legacy withTelemetry wrapper.
+ *
+ * Usage:
+ *   import { createRouter } from '@agentcash/router';
+ *   import { createTelemetryPlugin } from '@agentcash/telemetry/plugin';
+ *
+ *   const router = createRouter({
+ *     payeeAddress: '...',
+ *     plugin: createTelemetryPlugin({
+ *       clickhouse: {
+ *         url: process.env.TELEM_CLICKHOUSE_URL ?? 'http://localhost:8123',
+ *         database: process.env.TELEM_CLICKHOUSE_DATABASE,
+ *         username: process.env.TELEM_CLICKHOUSE_USERNAME,
+ *         password: process.env.TELEM_CLICKHOUSE_PASSWORD,
+ *       },
+ *     }),
+ *   });
+ */
+
+interface RequestMeta {
+    requestId: string;
+    method: string;
+    route: string;
+    origin: string;
+    referer: string | null;
+    walletAddress: string | null;
+    clientId: string | null;
+    sessionId: string | null;
+    contentType: string | null;
+    headers: Record<string, string>;
+    startTime: number;
+}
+interface PluginContext {
+    readonly requestId: string;
+    readonly route: string;
+    readonly walletAddress: string | null;
+    readonly clientId: string | null;
+    readonly sessionId: string | null;
+    verifiedWallet: string | null;
+    setVerifiedWallet(address: string): void;
+}
+interface PaymentEvent {
+    protocol: 'x402' | 'mpp';
+    payer: string;
+    amount: string;
+    network: string;
+}
+interface SettlementEvent {
+    protocol: 'x402' | 'mpp';
+    payer: string;
+    transaction: string;
+    network: string;
+}
+interface ResponseMeta {
+    statusCode: number;
+    statusText: string;
+    duration: number;
+    contentType: string | null;
+    headers: Record<string, string>;
+}
+interface ErrorEvent {
+    status: number;
+    message: string;
+    settled: boolean;
+}
+interface AlertEvent {
+    level: string;
+    message: string;
+    route: string;
+    meta?: Record<string, unknown>;
+}
+interface ProviderQuotaEvent {
+    provider: string;
+    route: string;
+    remaining: number | null;
+    limit: number | null;
+    level: string;
+    overage: string;
+    message: string;
+}
+/** RouterPlugin interface — must match @agentcash/router's RouterPlugin */
+interface RouterPlugin {
+    init?(config: {
+        origin?: string;
+    }): void | Promise<void>;
+    onRequest?(meta: RequestMeta): PluginContext;
+    onPaymentVerified?(ctx: PluginContext, payment: PaymentEvent): void;
+    onPaymentSettled?(ctx: PluginContext, settlement: SettlementEvent): void;
+    onResponse?(ctx: PluginContext, response: ResponseMeta): void;
+    onError?(ctx: PluginContext, error: ErrorEvent): void;
+    onAlert?(ctx: PluginContext, alert: AlertEvent): void;
+    onProviderQuota?(ctx: PluginContext, event: ProviderQuotaEvent): void;
+}
+interface TelemetryPluginConfig {
+    clickhouse: TelemetryConfig['clickhouse'];
+    /** If true, pings ClickHouse on init. */
+    verify?: boolean;
+    /** Console logging for dev. Default: false. */
+    console?: boolean;
+}
+declare function createTelemetryPlugin(config: TelemetryPluginConfig): RouterPlugin;
+
+export { type TelemetryPluginConfig, createTelemetryPlugin };

package/dist/router-plugin.d.ts

@@ -0,0 +1,109 @@
+import { T as TelemetryConfig } from './types-Bl8IwXin.js';
+
+/**
+ * RouterPlugin adapter for @agentcash/router.
+ *
+ * Bridges the router's plugin hooks into ClickHouse telemetry.
+ * Uses the same mcp_resource_invocations table as the legacy withTelemetry wrapper.
+ *
+ * Usage:
+ *   import { createRouter } from '@agentcash/router';
+ *   import { createTelemetryPlugin } from '@agentcash/telemetry/plugin';
+ *
+ *   const router = createRouter({
+ *     payeeAddress: '...',
+ *     plugin: createTelemetryPlugin({
+ *       clickhouse: {
+ *         url: process.env.TELEM_CLICKHOUSE_URL ?? 'http://localhost:8123',
+ *         database: process.env.TELEM_CLICKHOUSE_DATABASE,
+ *         username: process.env.TELEM_CLICKHOUSE_USERNAME,
+ *         password: process.env.TELEM_CLICKHOUSE_PASSWORD,
+ *       },
+ *     }),
+ *   });
+ */
+
+interface RequestMeta {
+    requestId: string;
+    method: string;
+    route: string;
+    origin: string;
+    referer: string | null;
+    walletAddress: string | null;
+    clientId: string | null;
+    sessionId: string | null;
+    contentType: string | null;
+    headers: Record<string, string>;
+    startTime: number;
+}
+interface PluginContext {
+    readonly requestId: string;
+    readonly route: string;
+    readonly walletAddress: string | null;
+    readonly clientId: string | null;
+    readonly sessionId: string | null;
+    verifiedWallet: string | null;
+    setVerifiedWallet(address: string): void;
+}
+interface PaymentEvent {
+    protocol: 'x402' | 'mpp';
+    payer: string;
+    amount: string;
+    network: string;
+}
+interface SettlementEvent {
+    protocol: 'x402' | 'mpp';
+    payer: string;
+    transaction: string;
+    network: string;
+}
+interface ResponseMeta {
+    statusCode: number;
+    statusText: string;
+    duration: number;
+    contentType: string | null;
+    headers: Record<string, string>;
+}
+interface ErrorEvent {
+    status: number;
+    message: string;
+    settled: boolean;
+}
+interface AlertEvent {
+    level: string;
+    message: string;
+    route: string;
+    meta?: Record<string, unknown>;
+}
+interface ProviderQuotaEvent {
+    provider: string;
+    route: string;
+    remaining: number | null;
+    limit: number | null;
+    level: string;
+    overage: string;
+    message: string;
+}
+/** RouterPlugin interface — must match @agentcash/router's RouterPlugin */
+interface RouterPlugin {
+    init?(config: {
+        origin?: string;
+    }): void | Promise<void>;
+    onRequest?(meta: RequestMeta): PluginContext;
+    onPaymentVerified?(ctx: PluginContext, payment: PaymentEvent): void;
+    onPaymentSettled?(ctx: PluginContext, settlement: SettlementEvent): void;
+    onResponse?(ctx: PluginContext, response: ResponseMeta): void;
+    onError?(ctx: PluginContext, error: ErrorEvent): void;
+    onAlert?(ctx: PluginContext, alert: AlertEvent): void;
+    onProviderQuota?(ctx: PluginContext, event: ProviderQuotaEvent): void;
+}
+interface TelemetryPluginConfig {
+    clickhouse: TelemetryConfig['clickhouse'];
+    /** If true, pings ClickHouse on init. */
+    verify?: boolean;
+    /** Console logging for dev. Default: false. */
+    console?: boolean;
+}
+declare function createTelemetryPlugin(config: TelemetryPluginConfig): RouterPlugin;
+
+export { type TelemetryPluginConfig, createTelemetryPlugin };