opentel-mcp 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.6.1
+
+### Fixed
+
+- `src/index.d.ts` re-exported values (`computeFingerprint`,
+  `toSpanAttributes`, `ATTRIBUTE_KEYS`, `METRIC_SAFE_ATTRIBUTES`,
+  `DEFAULT_CLASSIFIERS`, `DEFAULT_PRICING`, `defaultExtractor`,
+  `calculateCost`) from six `.js` modules that had no corresponding `.d.ts`
+  file, so any consumer with `strict`/`noImplicitAny` got a TS7016 error
+  just from importing the package. Added `src/fingerprint/compose.d.ts`,
+  `src/fingerprint/attributes.d.ts`, `src/fingerprint/classify/index.d.ts`,
+  `src/cost/pricing.d.ts`, `src/cost/extractor.d.ts`, and
+  `src/cost/calculator.d.ts`. Pre-existing since v0.4.0 (fingerprinting) and
+  v0.5.0 (cost tracking) — first caught verifying the v0.6.0 published
+  tarball.
+
 ## 0.6.0
 
 ### Added — Agent Thrash Detection

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opentel-mcp",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "One-line OpenTelemetry instrumentation for Model Context Protocol (MCP) servers",
   "type": "module",
   "main": "src/index.js",
@@ -25,9 +25,11 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --noEmit",
+    "verify:tarball": "node scripts/verify-tarball.js",
     "bench": "vitest bench --run",
     "prepack": "node scripts/strip-workspaces.js",
-    "postpack": "node scripts/restore-workspaces.js"
+    "postpack": "node scripts/restore-workspaces.js",
+    "prepublishOnly": "npm run verify:tarball"
   },
   "keywords": [
     "mcp",

package/src/cost/calculator.d.ts

@@ -0,0 +1,13 @@
+import type { PricingTable } from './types.d.ts';
+
+/**
+ * Calculates the USD cost of a request from its input/output token counts, a
+ * model name, and a pricing table. Never throws: an unrecognized model or an
+ * invalid token count resolves to `null` rather than an exception.
+ */
+export function calculateCost(
+  inputTokens: number,
+  outputTokens: number,
+  model: string,
+  pricingTable: PricingTable,
+): number | null;

package/src/cost/extractor.d.ts

@@ -0,0 +1,8 @@
+import type { UsageExtractor } from './types.d.ts';
+
+/**
+ * Default {@link UsageExtractor}. Recognizes Anthropic/OpenAI/Bedrock usage
+ * field conventions, JSON-in-text content, and the MCP `_meta.usage`
+ * extension point. Never throws — returns `null` for any unrecognized shape.
+ */
+export const defaultExtractor: UsageExtractor;

package/src/cost/pricing.d.ts

@@ -0,0 +1,8 @@
+import type { PricingTable } from './types.d.ts';
+
+/**
+ * Static per-model token pricing used to estimate MCP tool-call cost, in USD
+ * per 1M tokens. A best-effort snapshot — callers who need accurate cost
+ * attribution should supply their own {@link PricingTable}.
+ */
+export const DEFAULT_PRICING: PricingTable;

package/src/fingerprint/attributes.d.ts

@@ -0,0 +1,20 @@
+import type { Attributes } from '@opentelemetry/api';
+import type { FingerprintResult } from './types.d.ts';
+
+/** The `mcp.failure.*` OpenTelemetry span attribute keys. */
+export const ATTRIBUTE_KEYS: Readonly<
+  Record<'FINGERPRINT' | 'SIGNATURE' | 'CATEGORY' | 'ORIGIN' | 'ERROR_CLASS', string>
+>;
+
+/**
+ * Attribute keys safe to attach to metric labels — `category` and `origin`
+ * only; everything else in {@link ATTRIBUTE_KEYS} is unbounded or
+ * medium-cardinality and must stay span-only.
+ */
+export const METRIC_SAFE_ATTRIBUTES: readonly string[];
+
+/**
+ * Builds the span attributes for a fingerprinted failure. Never throws —
+ * returns `{}` if `result` is malformed in any way.
+ */
+export function toSpanAttributes(result: FingerprintResult): Attributes;

package/src/fingerprint/classify/index.d.ts

@@ -0,0 +1,18 @@
+import type { Classifier, FailureCategory, FingerprintContext } from '../types.d.ts';
+
+/**
+ * The ordered classifier registry: each classifier gets first refusal on an
+ * error, in order, and the first non-null category wins. `internal` is a
+ * catch-all that always matches, so it stays last.
+ */
+export const DEFAULT_CLASSIFIERS: readonly Classifier[];
+
+/**
+ * Runs `classifiers` against `err` in order, returning the first non-null
+ * category. Falls back to `"unknown"` if every classifier returns null.
+ */
+export function runClassifiers(
+  err: unknown,
+  ctx: FingerprintContext,
+  classifiers?: readonly Classifier[],
+): FailureCategory;

package/src/fingerprint/compose.d.ts

@@ -0,0 +1,11 @@
+import type { ComputeFingerprintOptions, FingerprintContext, FingerprintResult } from './types.d.ts';
+
+/**
+ * Computes a stable identity fingerprint for a failure. Never throws — falls
+ * back to a well-known "unfingerprintable" result on any unexpected shape.
+ */
+export function computeFingerprint(
+  err: unknown,
+  ctx: FingerprintContext,
+  opts?: ComputeFingerprintOptions,
+): FingerprintResult;