@cyanheads/mcp-ts-core 0.1.4 → 0.1.8

package/dist/utils/telemetry/instrumentation.js

@@ -35,29 +35,36 @@ function canUseNodeSDK() {
  * @returns Record of cloud-related resource attributes
  */
 function detectCloudResource() {
+    // Import constants inline — this function runs once at startup, not on the hot path.
+    // Cloud/deployment attrs use stable SEMRESATTRS_* names; deployment.environment.name
+    // is only in /incubating so we keep the string literal for that one attribute.
+    const CLOUD_PROVIDER = 'cloud.provider';
+    const CLOUD_PLATFORM = 'cloud.platform';
+    const CLOUD_REGION = 'cloud.region';
+    const DEPLOYMENT_ENV_NAME = 'deployment.environment.name';
     const attrs = {};
     // Cloudflare Workers
     if (runtimeCaps.isWorkerLike) {
-        attrs['cloud.provider'] = 'cloudflare';
-        attrs['cloud.platform'] = 'cloudflare_workers';
+        attrs[CLOUD_PROVIDER] = 'cloudflare';
+        attrs[CLOUD_PLATFORM] = 'cloudflare_workers';
     }
     // AWS Lambda
     if (typeof process !== 'undefined' && process.env?.AWS_LAMBDA_FUNCTION_NAME) {
-        attrs['cloud.provider'] = 'aws';
-        attrs['cloud.platform'] = 'aws_lambda';
+        attrs[CLOUD_PROVIDER] = 'aws';
+        attrs[CLOUD_PLATFORM] = 'aws_lambda';
         if (process.env.AWS_REGION) {
-            attrs['cloud.region'] = process.env.AWS_REGION;
+            attrs[CLOUD_REGION] = process.env.AWS_REGION;
         }
     }
     // GCP Cloud Functions/Cloud Run
     if (typeof process !== 'undefined' && (process.env?.FUNCTION_TARGET || process.env?.K_SERVICE)) {
-        attrs['cloud.provider'] = 'gcp';
-        attrs['cloud.platform'] = process.env.FUNCTION_TARGET ? 'gcp_cloud_functions' : 'gcp_cloud_run';
+        attrs[CLOUD_PROVIDER] = 'gcp';
+        attrs[CLOUD_PLATFORM] = process.env.FUNCTION_TARGET ? 'gcp_cloud_functions' : 'gcp_cloud_run';
         if (process.env.GCP_REGION) {
-            attrs['cloud.region'] = process.env.GCP_REGION;
+            attrs[CLOUD_REGION] = process.env.GCP_REGION;
         }
     }
-    attrs['deployment.environment.name'] = config.environment;
+    attrs[DEPLOYMENT_ENV_NAME] = config.environment;
     return attrs;
 }
 /**
@@ -109,8 +116,8 @@ export async function initializeOpenTelemetry() {
         }
         try {
             // Lazy-load Node-specific modules
-            const [{ getNodeAutoInstrumentations }, { OTLPMetricExporter }, { OTLPTraceExporter }, { PinoInstrumentation }, { resourceFromAttributes }, { PeriodicExportingMetricReader }, { NodeSDK }, { BatchSpanProcessor, TraceIdRatioBasedSampler }, { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION },] = await Promise.all([
-                import('@opentelemetry/auto-instrumentations-node'),
+            const [{ HttpInstrumentation }, { OTLPMetricExporter }, { OTLPTraceExporter }, { PinoInstrumentation }, { resourceFromAttributes }, { PeriodicExportingMetricReader }, { NodeSDK }, { BatchSpanProcessor, TraceIdRatioBasedSampler }, { ATTR_SERVICE_NAME, ATTR_SERVICE_VERSION },] = await Promise.all([
+                import('@opentelemetry/instrumentation-http'),
                 import('@opentelemetry/exporter-metrics-otlp-http'),
                 import('@opentelemetry/exporter-trace-otlp-http'),
                 import('@opentelemetry/instrumentation-pino'),
@@ -118,7 +125,7 @@ export async function initializeOpenTelemetry() {
                 import('@opentelemetry/sdk-metrics'),
                 import('@opentelemetry/sdk-node'),
                 import('@opentelemetry/sdk-trace-node'),
-                import('@opentelemetry/semantic-conventions/incubating'),
+                import('@opentelemetry/semantic-conventions'),
             ]);
             const otelLogLevelString = config.openTelemetry.logLevel.toUpperCase();
             const otelLogLevel = DiagLogLevel[otelLogLevelString] ?? DiagLogLevel.INFO;
@@ -154,12 +161,8 @@ export async function initializeOpenTelemetry() {
                 ...(metricReader && { metricReader }),
                 sampler: new TraceIdRatioBasedSampler(config.openTelemetry.samplingRatio),
                 instrumentations: [
-                    getNodeAutoInstrumentations({
-                        '@opentelemetry/instrumentation-http': {
-                            enabled: true,
-                            ignoreIncomingRequestHook: (req) => req.url === '/healthz',
-                        },
-                        '@opentelemetry/instrumentation-fs': { enabled: false },
+                    new HttpInstrumentation({
+                        ignoreIncomingRequestHook: (req) => req.url === '/healthz',
                     }),
                     new PinoInstrumentation({
                         logHook: (_span, record) => {
@@ -208,8 +211,9 @@ export async function shutdownOpenTelemetry(timeoutMs = 5000) {
     try {
         const shutdownPromise = sdk.shutdown();
         const { promise: timeoutPromise, reject } = Promise.withResolvers();
-        setTimeout(() => reject(new Error('OpenTelemetry SDK shutdown timeout')), timeoutMs);
+        const timer = setTimeout(() => reject(new Error('OpenTelemetry SDK shutdown timeout')), timeoutMs);
         await Promise.race([shutdownPromise, timeoutPromise]);
+        clearTimeout(timer);
         diag.info('OpenTelemetry SDK terminated successfully.');
     }
     catch (error) {

package/dist/utils/telemetry/instrumentation.js.map

@@ -1 +1 @@
-{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../../src/utils/telemetry/instrumentation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../../../src/utils/telemetry/instrumentation.ts"],"names":[],"mappings":"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"}

package/dist/utils/telemetry/metrics.d.ts

@@ -95,76 +95,12 @@ export declare function createHistogram(name: string, description: string, unit?
 /**
  * Creates an observable gauge for async/callback-based measurements.
  * Gauges are polled periodically by the metrics SDK and report current values.
- * Use for measuring things like memory usage, queue depth, temperature, etc.
  *
  * @param name - Metric name (should use dot notation)
  * @param description - Human-readable description
  * @param callback - Async function returning the current metric value
  * @param unit - Optional unit of measurement
  * @returns ObservableGauge instance
- *
- * @example
- * ```typescript
- * // Monitor heap memory usage
- * createObservableGauge(
- *   'process.memory.heap_used',
- *   'Current heap memory usage',
- *   () => {
- *     if (typeof process !== 'undefined') {
- *       return process.memoryUsage().heapUsed;
- *     }
- *     return 0;
- *   },
- *   'bytes'
- * );
- * ```
  */
 export declare function createObservableGauge(name: string, description: string, callback: () => Promise<number> | number, unit?: string): ObservableGauge;
-/**
- * Creates an observable counter for async/callback-based cumulative measurements.
- * Similar to ObservableGauge but for monotonically increasing values.
- * The callback is registered via `addCallback` and polled by the metrics SDK on each collection cycle.
- *
- * @param name - Metric name (should use dot notation, e.g., 'jobs.processed')
- * @param description - Human-readable description
- * @param callback - Async function returning the current cumulative count
- * @param unit - Optional unit of measurement (default: '1')
- * @returns ObservableCounter instance
- *
- * @example
- * ```typescript
- * let totalProcessed = 0;
- *
- * createObservableCounter(
- *   'jobs.processed',
- *   'Total jobs processed since startup',
- *   () => totalProcessed,
- *   '{jobs}'
- * );
- * ```
- */
-export declare function createObservableCounter(name: string, description: string, callback: () => Promise<number> | number, unit?: string): import("@opentelemetry/api").ObservableCounter<import("@opentelemetry/api").Attributes>;
-/**
- * Creates an observable up-down counter for async/callback-based measurements
- * that can increase or decrease.
- * The callback is registered via `addCallback` and polled by the metrics SDK on each collection cycle.
- *
- * @param name - Metric name (should use dot notation, e.g., 'queue.size')
- * @param description - Human-readable description of what the metric measures
- * @param callback - Async function returning the current value (can be positive or negative)
- * @param unit - Optional unit of measurement (default: '1')
- * @returns ObservableUpDownCounter instance
- *
- * @example
- * ```typescript
- * // Track current queue size
- * createObservableUpDownCounter(
- *   'queue.size',
- *   'Current number of items in queue',
- *   async () => await getQueueSize(),
- *   '{items}'
- * );
- * ```
- */
-export declare function createObservableUpDownCounter(name: string, description: string, callback: () => Promise<number> | number, unit?: string): import("@opentelemetry/api").ObservableUpDownCounter<import("@opentelemetry/api").Attributes>;
 //# sourceMappingURL=metrics.d.ts.map

package/dist/utils/telemetry/metrics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,KAAK,EAEV,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAI5B;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAK7C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,OAAO,CAGpF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,SAAM,uFAGhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAI3F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EACxC,IAAI,CAAC,EAAE,MAAM,GACZ,eAAe,CAQjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EACxC,IAAI,SAAM,2FAQX;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EACxC,IAAI,SAAM,iGAQX"}
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,KAAK,EAEV,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAI5B;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,KAAK,CAK7C;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,OAAO,CAGpF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,SAAM,uFAGhF;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAI3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,EACxC,IAAI,CAAC,EAAE,MAAM,GACZ,eAAe,CAQjB"}

package/dist/utils/telemetry/metrics.js

@@ -108,29 +108,12 @@ export function createHistogram(name, description, unit) {
 /**
  * Creates an observable gauge for async/callback-based measurements.
  * Gauges are polled periodically by the metrics SDK and report current values.
- * Use for measuring things like memory usage, queue depth, temperature, etc.
  *
  * @param name - Metric name (should use dot notation)
  * @param description - Human-readable description
  * @param callback - Async function returning the current metric value
  * @param unit - Optional unit of measurement
  * @returns ObservableGauge instance
- *
- * @example
- * ```typescript
- * // Monitor heap memory usage
- * createObservableGauge(
- *   'process.memory.heap_used',
- *   'Current heap memory usage',
- *   () => {
- *     if (typeof process !== 'undefined') {
- *       return process.memoryUsage().heapUsed;
- *     }
- *     return 0;
- *   },
- *   'bytes'
- * );
- * ```
  */
 export function createObservableGauge(name, description, callback, unit) {
     const meter = getMeter();
@@ -141,65 +124,4 @@ export function createObservableGauge(name, description, callback, unit) {
     });
     return gauge;
 }
-/**
- * Creates an observable counter for async/callback-based cumulative measurements.
- * Similar to ObservableGauge but for monotonically increasing values.
- * The callback is registered via `addCallback` and polled by the metrics SDK on each collection cycle.
- *
- * @param name - Metric name (should use dot notation, e.g., 'jobs.processed')
- * @param description - Human-readable description
- * @param callback - Async function returning the current cumulative count
- * @param unit - Optional unit of measurement (default: '1')
- * @returns ObservableCounter instance
- *
- * @example
- * ```typescript
- * let totalProcessed = 0;
- *
- * createObservableCounter(
- *   'jobs.processed',
- *   'Total jobs processed since startup',
- *   () => totalProcessed,
- *   '{jobs}'
- * );
- * ```
- */
-export function createObservableCounter(name, description, callback, unit = '1') {
-    const meter = getMeter();
-    const counter = meter.createObservableCounter(name, { description, unit });
-    counter.addCallback(async (result) => {
-        result.observe(await callback());
-    });
-    return counter;
-}
-/**
- * Creates an observable up-down counter for async/callback-based measurements
- * that can increase or decrease.
- * The callback is registered via `addCallback` and polled by the metrics SDK on each collection cycle.
- *
- * @param name - Metric name (should use dot notation, e.g., 'queue.size')
- * @param description - Human-readable description of what the metric measures
- * @param callback - Async function returning the current value (can be positive or negative)
- * @param unit - Optional unit of measurement (default: '1')
- * @returns ObservableUpDownCounter instance
- *
- * @example
- * ```typescript
- * // Track current queue size
- * createObservableUpDownCounter(
- *   'queue.size',
- *   'Current number of items in queue',
- *   async () => await getQueueSize(),
- *   '{items}'
- * );
- * ```
- */
-export function createObservableUpDownCounter(name, description, callback, unit = '1') {
-    const meter = getMeter();
-    const counter = meter.createObservableUpDownCounter(name, { description, unit });
-    counter.addCallback(async (result) => {
-        result.observe(await callback());
-    });
-    return counter;
-}
 //# sourceMappingURL=metrics.js.map

package/dist/utils/telemetry/metrics.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/utils/telemetry/metrics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../../src/utils/telemetry/metrics.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAIL,OAAO,GAER,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,OAAO,OAAO,CAAC,QAAQ,CACrB,IAAI,IAAI,MAAM,CAAC,aAAa,CAAC,WAAW,EACxC,MAAM,CAAC,aAAa,CAAC,cAAc,CACpC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,WAAmB,EAAE,IAAI,GAAG,GAAG;IACzE,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,OAAO,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,WAAmB,EAAE,IAAI,GAAG,GAAG;IAC/E,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,OAAO,KAAK,CAAC,mBAAmB,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;AAChE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,WAAmB,EAAE,IAAa;IAC9E,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IAC/D,OAAO,KAAK,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAY,EACZ,WAAmB,EACnB,QAAwC,EACxC,IAAa;IAEb,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;IAC/D,MAAM,KAAK,GAAG,KAAK,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzD,KAAK,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;QACjC,MAAM,CAAC,OAAO,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/mcp-ts-core",
-  "version": "0.1.4",
+  "version": "0.1.8",
   "mcpName": "io.github.cyanheads/mcp-ts-core",
   "description": "TypeScript framework for building Model Context Protocol (MCP) servers. Declarative tool/resource/prompt definitions, pluggable auth, multi-backend storage, OpenTelemetry observability, and support for both local (stdio/HTTP) and edge (Cloudflare Workers) runtimes.",
   "main": "dist/core/app.js",
@@ -149,10 +149,10 @@
     "rollup": "4.59.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.7",
-    "@cloudflare/workers-types": "^4.20260313.1",
+    "@biomejs/biome": "2.4.8",
+    "@cloudflare/workers-types": "^4.20260317.1",
     "@hono/otel": "^1.1.1",
-    "@opentelemetry/auto-instrumentations-node": "^0.71.0",
+    "@opentelemetry/instrumentation-http": "^0.213.0",
     "@opentelemetry/exporter-metrics-otlp-http": "^0.213.0",
     "@opentelemetry/exporter-trace-otlp-http": "^0.213.0",
     "@opentelemetry/instrumentation-pino": "^0.59.0",
@@ -161,8 +161,8 @@
     "@opentelemetry/sdk-node": "^0.213.0",
     "@opentelemetry/sdk-trace-node": "^2.6.0",
     "@opentelemetry/semantic-conventions": "^1.40.0",
-    "@supabase/supabase-js": "^2.99.1",
-    "@types/bun": "^1.3.10",
+    "@supabase/supabase-js": "^2.99.3",
+    "@types/bun": "^1.3.11",
     "@types/diff": "^8.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.5.0",
@@ -171,28 +171,28 @@
     "@types/validator": "^13.15.10",
     "@vitest/coverage-istanbul": "4.1.0",
     "@vitest/ui": "4.1.0",
-    "bun-types": "^1.3.10",
+    "bun-types": "^1.3.11",
     "chrono-node": "^2.9.0",
     "clipboardy": "^5.3.1",
     "depcheck": "^1.4.7",
     "execa": "^9.6.1",
     "fast-check": "^4.6.0",
     "ignore": "^7.0.5",
-    "msw": "^2.12.10",
+    "msw": "^2.12.13",
     "node-cron": "^4.2.1",
-    "openai": "^6.29.0",
+    "openai": "^6.32.0",
     "papaparse": "^5.5.3",
     "partial-json": "^0.1.7",
     "pdf-lib": "^1.17.1",
     "pino-pretty": "^13.1.3",
-    "sanitize-html": "^2.17.1",
+    "sanitize-html": "^2.17.2",
     "repomix": "^1.12.0",
     "tsc-alias": "^1.8.16",
     "typedoc": "^0.28.17",
     "typescript": "^5.9.3",
     "unpdf": "^1.4.0",
     "validator": "^13.15.26",
-    "vite": "8.0.0",
+    "vite": "8.0.1",
     "vitest": "^4.1.0"
   },
   "keywords": [
@@ -255,13 +255,13 @@
     "@opentelemetry/api": "^1.9.0",
     "dotenv": "^17.3.1",
     "hono": "^4.12.8",
-    "jose": "^6.2.1",
+    "jose": "^6.2.2",
     "pino": "^10.3.1"
   },
   "peerDependencies": {
     "zod": "^4.3.6",
     "@hono/otel": "",
-    "@opentelemetry/auto-instrumentations-node": "",
+    "@opentelemetry/instrumentation-http": "",
     "@opentelemetry/exporter-metrics-otlp-http": "",
     "@opentelemetry/exporter-trace-otlp-http": "",
     "@opentelemetry/instrumentation-pino": "",
@@ -288,7 +288,7 @@
     "@hono/otel": {
       "optional": true
     },
-    "@opentelemetry/auto-instrumentations-node": {
+    "@opentelemetry/instrumentation-http": {
       "optional": true
     },
     "@opentelemetry/exporter-metrics-otlp-http": {

package/skills/add-test/SKILL.md

@@ -0,0 +1,216 @@
+---
+name: add-test
+description: >
+  Scaffold a test file for an existing tool, resource, or service. Use when the user asks to add tests, improve coverage, or when a definition exists without a colocated test file.
+metadata:
+  author: cyanheads
+  version: "1.0"
+  audience: external
+  type: reference
+---
+
+## Context
+
+Tests use Vitest and `createMockContext` from `@cyanheads/mcp-ts-core/testing`. Test files are colocated with their source: `foo.tool.ts` gets `foo.tool.test.ts` in the same directory.
+
+For the full `createMockContext` API and testing patterns, read:
+
+    skills/api-testing/SKILL.md
+
+## Steps
+
+1. **Identify the target** — which tool, resource, or service needs tests
+2. **Read the source file** — understand the handler's logic, input/output schemas, error paths, and which `ctx` features it uses
+3. **Create the test file** colocated with the source
+4. **Write test cases** covering happy path, error paths, and edge cases
+5. **Run `npm test`** to verify
+6. **Run `bun run devcheck`** to verify types
+
+## Determining What to Test
+
+Read the handler and identify:
+
+| Aspect | Test Strategy |
+|:-------|:-------------|
+| **Happy path** | Valid input → expected output. Always include at least one. |
+| **Input variations** | Optional fields omitted, defaults applied, boundary values |
+| **Error paths** | Invalid state, missing resources, service failures → correct error thrown |
+| **`ctx.state` usage** | Use `createMockContext({ tenantId: 'test' })` to enable storage |
+| **`ctx.elicit` / `ctx.sample`** | Mock with `vi.fn()`, also test the absent case (undefined) |
+| **`ctx.progress`** | Use `createMockContext({ progress: true })` for task tools |
+| **`format` function** | Test separately if defined — it's pure, no ctx needed |
+| **Auth scopes** | Not tested at handler level (framework enforces) — skip |
+
+## Templates
+
+### Tool test
+
+```typescript
+/**
+ * @fileoverview Tests for {{TOOL_NAME}} tool.
+ * @module mcp-server/tools/definitions/{{TOOL_NAME}}.test
+ */
+
+import { describe, expect, it } from 'vitest';
+import { createMockContext } from '@cyanheads/mcp-ts-core/testing';
+import { {{TOOL_EXPORT}} } from './{{tool-name}}.tool.js';
+
+describe('{{TOOL_EXPORT}}', () => {
+  it('returns expected output for valid input', async () => {
+    const ctx = createMockContext();
+    const input = {{TOOL_EXPORT}}.input.parse({
+      // valid input matching the Zod schema
+    });
+    const result = await {{TOOL_EXPORT}}.handler(input, ctx);
+    expect(result).toMatchObject({
+      // expected output shape
+    });
+  });
+
+  it('throws on invalid state', async () => {
+    const ctx = createMockContext();
+    const input = {{TOOL_EXPORT}}.input.parse({
+      // input that triggers an error path
+    });
+    await expect({{TOOL_EXPORT}}.handler(input, ctx)).rejects.toThrow();
+  });
+
+  it('formats output correctly', () => {
+    const output = { /* mock output matching the output schema */ };
+    const blocks = {{TOOL_EXPORT}}.format!(output);
+    expect(blocks).toHaveLength(1);
+    expect(blocks[0].type).toBe('text');
+  });
+});
+```
+
+### Resource test
+
+```typescript
+/**
+ * @fileoverview Tests for {{RESOURCE_NAME}} resource.
+ * @module mcp-server/resources/definitions/{{RESOURCE_NAME}}.test
+ */
+
+import { describe, expect, it } from 'vitest';
+import { createMockContext } from '@cyanheads/mcp-ts-core/testing';
+import { {{RESOURCE_EXPORT}} } from './{{resource-name}}.resource.js';
+
+describe('{{RESOURCE_EXPORT}}', () => {
+  it('returns data for valid params', async () => {
+    const ctx = createMockContext({ tenantId: 'test-tenant' });
+    const params = {{RESOURCE_EXPORT}}.params.parse({
+      // valid params matching the Zod schema
+    });
+    const result = await {{RESOURCE_EXPORT}}.handler(params, ctx);
+    expect(result).toBeDefined();
+  });
+
+  it('throws when resource not found', async () => {
+    const ctx = createMockContext({ tenantId: 'test-tenant' });
+    const params = {{RESOURCE_EXPORT}}.params.parse({
+      // params for a non-existent resource
+    });
+    await expect({{RESOURCE_EXPORT}}.handler(params, ctx)).rejects.toThrow();
+  });
+
+  it('lists available resources', async () => {
+    const listing = await {{RESOURCE_EXPORT}}.list!();
+    expect(listing.resources).toBeInstanceOf(Array);
+    expect(listing.resources.length).toBeGreaterThan(0);
+    for (const r of listing.resources) {
+      expect(r).toHaveProperty('uri');
+      expect(r).toHaveProperty('name');
+    }
+  });
+});
+```
+
+### Service test
+
+```typescript
+/**
+ * @fileoverview Tests for {{SERVICE_NAME}} service.
+ * @module services/{{domain}}/{{SERVICE_NAME}}.test
+ */
+
+import { beforeEach, describe, expect, it } from 'vitest';
+import { createMockContext } from '@cyanheads/mcp-ts-core/testing';
+import { init{{ServiceClass}}, get{{ServiceClass}} } from './{{service-name}}-service.js';
+
+describe('{{ServiceClass}}', () => {
+  beforeEach(() => {
+    // Re-initialize with fresh config/storage per suite
+    init{{ServiceClass}}(mockConfig, mockStorage);
+  });
+
+  it('performs the expected operation', async () => {
+    const ctx = createMockContext({ tenantId: 'test-tenant' });
+    const service = get{{ServiceClass}}();
+    const result = await service.doWork('input', ctx);
+    expect(result).toBeDefined();
+  });
+
+  it('throws when not initialized', () => {
+    // Reset the singleton — this is the only case where accessing
+    // the module internals is acceptable
+    expect(() => get{{ServiceClass}}()).toThrow(/not initialized/);
+  });
+});
+```
+
+### Task tool test
+
+For tools with `task: true`, use `createMockContext({ progress: true })`:
+
+```typescript
+it('reports progress during execution', async () => {
+  const ctx = createMockContext({ progress: true });
+  const input = {{TOOL_EXPORT}}.input.parse({ count: 3, delayMs: 10 });
+  await {{TOOL_EXPORT}}.handler(input, ctx);
+
+  const progress = ctx.progress as ContextProgress & {
+    _total: number;
+    _completed: number;
+    _messages: string[];
+  };
+  expect(progress._total).toBe(3);
+  expect(progress._completed).toBe(3);
+});
+
+it('respects cancellation', async () => {
+  const controller = new AbortController();
+  const ctx = createMockContext({ progress: true, signal: controller.signal });
+  const input = {{TOOL_EXPORT}}.input.parse({ count: 100, delayMs: 10 });
+
+  // Abort after a short delay
+  setTimeout(() => controller.abort(), 50);
+  const result = await {{TOOL_EXPORT}}.handler(input, ctx);
+
+  // Should have stopped early
+  expect(result.finalCount).toBeGreaterThan(0);
+});
+```
+
+## Generating Tests from Schemas
+
+When scaffolding tests for an existing handler, use the Zod schemas to generate meaningful test cases:
+
+1. **Read `input` schema** — identify required fields, optional fields with defaults, constrained types (enums, min/max, patterns)
+2. **Read `output` schema** — know what shape to assert against
+3. **Happy path** — construct the simplest valid input, assert output matches schema
+4. **Defaults** — omit optional fields, verify defaults are applied in the output
+5. **Boundaries** — if the schema has `.min()`, `.max()`, `.length()`, test at the boundaries
+6. **Error paths** — trace the handler logic for throw conditions, construct inputs that trigger each
+
+## Checklist
+
+- [ ] Test file created at `src/.../{{name}}.test.ts` (colocated with source)
+- [ ] JSDoc `@fileoverview` and `@module` header present
+- [ ] Happy path tested with valid input → expected output
+- [ ] Error paths tested (at least one `.rejects.toThrow()`)
+- [ ] `format` function tested if defined
+- [ ] `createMockContext` options match handler's ctx usage (`tenantId`, `progress`, `elicit`, `sample`)
+- [ ] Service re-initialized in `beforeEach` if handler depends on a service singleton
+- [ ] `npm test` passes
+- [ ] `bun run devcheck` passes

package/skills/api-utils/SKILL.md

@@ -137,7 +137,7 @@ Both functions throw `McpError(InternalError)` only on unexpected heuristic fail
 
 | Export | Signature | Notes |
 |:-------|:----------|:------|
-| `initializeOpenTelemetry` | `() -> Promise<void>` | Idempotent. Initializes `NodeSDK` with OTLP trace + metrics exporters, `TraceIdRatioBasedSampler`, Node auto-instrumentations, and Pino log injection. No-ops when `OTEL_ENABLED=false` or in Worker/Edge runtimes where `NodeSDK` is unavailable. Safe to call multiple times. |
+| `initializeOpenTelemetry` | `() -> Promise<void>` | Idempotent. Initializes `NodeSDK` with OTLP trace + metrics exporters, `TraceIdRatioBasedSampler`, HTTP instrumentation, and Pino log injection. No-ops when `OTEL_ENABLED=false` or in Worker/Edge runtimes where `NodeSDK` is unavailable. Safe to call multiple times. |
 | `shutdownOpenTelemetry` | `(timeoutMs?: number) -> Promise<void>` | Gracefully flushes and shuts down the SDK. `timeoutMs` defaults to `5000`. Resets internal state so the next `initializeOpenTelemetry()` call can reinitialize. No-op when SDK was never started. |
 | `sdk` | `NodeSDK \| null` | The live SDK instance, or `null` when telemetry is disabled, in a Worker runtime, or after shutdown. |
 
@@ -149,9 +149,7 @@ Both functions throw `McpError(InternalError)` only on unexpected heuristic fail
 | `createCounter` | `(name: string, description: string, unit?: string) -> Counter` | Monotonically increasing counter. `unit` defaults to `'1'`. |
 | `createUpDownCounter` | `(name: string, description: string, unit?: string) -> UpDownCounter` | Bidirectional counter (active connections, queue depth, etc.). `unit` defaults to `'1'`. |
 | `createHistogram` | `(name: string, description: string, unit?: string) -> Histogram` | Distribution recording (latency, sizes). `unit` optional. |
-| `createObservableGauge` | `(name: string, description: string, callback: () => Promise<number> \| number, unit?: string) -> ObservableGauge` | Polled gauge. `callback` is registered via `addCallback`; invoked on each SDK collection cycle. `unit` optional. |
-| `createObservableCounter` | `(name: string, description: string, callback: () => Promise<number> \| number, unit?: string) -> ObservableCounter` | Polled cumulative counter. `unit` defaults to `'1'`. |
-| `createObservableUpDownCounter` | `(name: string, description: string, callback: () => Promise<number> \| number, unit?: string) -> ObservableUpDownCounter` | Polled bidirectional counter. `unit` defaults to `'1'`. |
+| `createObservableGauge` | `(name: string, description: string, callback: () => Promise<number> \| number, unit?: string) -> ObservableGauge` | Polled gauge. `callback` is registered via `addCallback`; invoked on each SDK collection cycle. `unit` optional. For other observable instrument types, use `getMeter()` directly. |
 
 ### `telemetry/trace`
 
@@ -164,8 +162,8 @@ Both functions throw `McpError(InternalError)` only on unexpected heuristic fail
 | `createContextWithParentTrace` | `(parentHeaders: Headers \| Record<string, string \| undefined>, operation: string) -> RequestContext` | Extracts `traceparent` from headers and creates a child `RequestContext` inheriting `traceId`/`parentSpanId`. |
 | `injectCurrentContextInto` | `<T extends Record<string, unknown>>(carrier: T) -> T` | Injects the active OTel context (traceparent, tracestate, etc.) into `carrier` via `propagation.inject`. Returns the same object. |
 
-### `telemetry/semconv`
+### `telemetry/attributes`
 
-51 `ATTR_*` constant exports covering: service, deployment, cloud, HTTP, URL, error/exception, code, network, user agent, MCP tool execution (name, input/output bytes, duration, success, error code, memory), MCP resource (URI, MIME type, size), MCP request context (request ID, operation, tenant ID, client ID), and MCP session (ID).
+MCP-specific `ATTR_*` constant exports for span and metric attributes. Covers: code execution (`code.function.name`, `code.namespace`), MCP tool execution (name, input/output bytes, duration, success, error code), MCP resource (URI, MIME type, size, duration, success, error code), MCP request context (tenant ID, client ID), MCP session events, MCP storage, GenAI semantic conventions, speech, graph, auth, task, and error classification attributes.
 
-Additional categories (prompts, storage, GenAI, speech, graph, auth, tasks, error classification) are defined in the internal `semconv.ts` module but not re-exported from the `/utils` barrel — they are used by the framework's handler factories and service instrumentation internally.
+Standard OTel semantic conventions (HTTP, cloud, service, network, etc.) are NOT re-exported — import those directly from `@opentelemetry/semantic-conventions` if needed.