mcp-server-framework 1.0.0

package/build/telemetry/core/constants.js

@@ -0,0 +1,207 @@
+/**
+ * Telemetry Module Constants
+ *
+ * Centralized constants for the OpenTelemetry integration module including:
+ * - Semantic attribute names for MCP operations
+ * - Metric attribute names
+ * - Log component identifiers
+ * - Log messages
+ * - Metric names
+ *
+ * @module server/telemetry/core/constants
+ */
+// ============================================================================
+// Configuration Constants
+// ============================================================================
+/**
+ * Default telemetry configuration values.
+ */
+export const TELEMETRY_DEFAULTS = {
+    /** Default service name (last resort when options.name is also missing) */
+    SERVICE_NAME: "mcp-server",
+    /** Default service version when not available */
+    SERVICE_VERSION_FALLBACK: "unknown",
+    /** Default metric exporters */
+    METRICS_EXPORTER: "otlp,prometheus",
+    /** OTEL standard OTLP/HTTP endpoint (per OTEL specification) */
+    OTLP_ENDPOINT: "http://localhost:4318",
+};
+/**
+ * Environment variable names for telemetry configuration.
+ *
+ * Includes both framework-managed and standard OTEL variables.
+ * Standard vars are parsed in the config system so they can be set
+ * via config file, then passed through to the SDK and exporters.
+ * See: https://opentelemetry.io/docs/specs/otel/configuration/sdk-environment-variables/
+ */
+export const TELEMETRY_ENV_VARS = {
+    // Framework-managed
+    /** Enable/disable OpenTelemetry (framework master toggle) */
+    OTEL_ENABLED: "OTEL_ENABLED",
+    /** Service name (also read natively by SDK resource detector) */
+    OTEL_SERVICE_NAME: "OTEL_SERVICE_NAME",
+    /** Metric exporters: otlp, prometheus, console, none (comma-separated) */
+    OTEL_METRICS_EXPORTER: "OTEL_METRICS_EXPORTER",
+    // Standard OTEL (pass-through)
+    /** OTLP exporter endpoint URL */
+    OTEL_EXPORTER_OTLP_ENDPOINT: "OTEL_EXPORTER_OTLP_ENDPOINT",
+    /** Trace exporter selection */
+    OTEL_TRACES_EXPORTER: "OTEL_TRACES_EXPORTER",
+    /** Log exporter selection (default: 'none' — framework has own logger) */
+    OTEL_LOGS_EXPORTER: "OTEL_LOGS_EXPORTER",
+    /** SDK diagnostic log level */
+    OTEL_LOG_LEVEL: "OTEL_LOG_LEVEL",
+    /** Periodic metric export interval (ms) */
+    OTEL_METRIC_EXPORT_INTERVAL: "OTEL_METRIC_EXPORT_INTERVAL",
+};
+// ============================================================================
+// Semantic Attribute Names
+// ============================================================================
+/**
+ * Semantic attribute names for MCP operations.
+ * Follow OpenTelemetry semantic conventions pattern.
+ *
+ * Note: Application-specific attributes should be defined in the
+ * app layer (src/app/telemetry.ts) to keep the framework generic.
+ */
+export const MCP_ATTRIBUTES = {
+    /** MCP tool name */
+    TOOL_NAME: "mcp.tool.name",
+    /** MCP resource URI */
+    RESOURCE_URI: "mcp.resource.uri",
+    /** MCP resource template URI */
+    RESOURCE_TEMPLATE: "mcp.resource.template",
+    /** MCP prompt name */
+    PROMPT_NAME: "mcp.prompt.name",
+    /** MCP request ID */
+    REQUEST_ID: "mcp.request.id",
+    /** MCP session ID */
+    SESSION_ID: "mcp.session.id",
+    /** Operation type (tool_call, resource_read, prompt_generate) */
+    OPERATION: "mcp.operation",
+    /** Whether the operation succeeded */
+    SUCCESS: "mcp.success",
+    /** Result content type count */
+    RESULT_CONTENT_COUNT: "mcp.result.content_count",
+    /** Whether the result indicates an error */
+    RESULT_IS_ERROR: "mcp.result.is_error",
+};
+/**
+ * Semantic attribute names for server metrics.
+ */
+export const METRIC_ATTRIBUTES = {
+    /** Tool name being invoked */
+    TOOL_NAME: "tool.name",
+    /** Transport type (http, sse, stdio) */
+    TRANSPORT: "transport",
+    /** Request success status */
+    SUCCESS: "success",
+    /** Error type */
+    ERROR_TYPE: "error.type",
+    /** Component where error occurred */
+    COMPONENT: "component",
+    /** Previous connection state */
+    PREVIOUS_STATE: "connection.state.previous",
+    /** Current connection state */
+    CURRENT_STATE: "connection.state.current",
+};
+// ============================================================================
+// Metric Names
+// ============================================================================
+/**
+ * OpenTelemetry metric instrument names.
+ */
+export const METRIC_NAMES = {
+    /** Counter for total requests */
+    REQUESTS_TOTAL: "mcp.server.requests",
+    /** Histogram for request duration */
+    REQUEST_DURATION: "mcp.server.request.duration",
+    /** UpDownCounter for active sessions */
+    SESSIONS_ACTIVE: "mcp.server.sessions.active",
+    /** Counter for connection state changes */
+    CONNECTION_STATE_CHANGES: "mcp.server.connection.state_changes",
+    /** Counter for errors */
+    ERRORS_TOTAL: "mcp.server.errors",
+    /** Gauge for server uptime */
+    UPTIME: "mcp.server.uptime",
+    /** Gauge for heap memory used */
+    MEMORY_HEAP_USED: "mcp.server.memory.heap_used",
+    /** Gauge for RSS memory */
+    MEMORY_RSS: "mcp.server.memory.rss",
+};
+/**
+ * Metric descriptions for documentation.
+ */
+export const METRIC_DESCRIPTIONS = {
+    [METRIC_NAMES.REQUESTS_TOTAL]: "Total number of MCP requests processed",
+    [METRIC_NAMES.REQUEST_DURATION]: "Duration of MCP requests in milliseconds",
+    [METRIC_NAMES.SESSIONS_ACTIVE]: "Number of active sessions",
+    [METRIC_NAMES.CONNECTION_STATE_CHANGES]: "Number of connection state changes",
+    [METRIC_NAMES.ERRORS_TOTAL]: "Total number of errors",
+    [METRIC_NAMES.UPTIME]: "Server uptime in seconds",
+    [METRIC_NAMES.MEMORY_HEAP_USED]: "Heap memory used in bytes",
+    [METRIC_NAMES.MEMORY_RSS]: "Resident set size in bytes",
+};
+/**
+ * Metric units following OpenTelemetry conventions.
+ */
+export const METRIC_UNITS = {
+    COUNT: "1",
+    MILLISECONDS: "ms",
+    SECONDS: "s",
+    BYTES: "By",
+};
+// ============================================================================
+// Log Component Identifiers
+// ============================================================================
+/**
+ * Logger component identifiers for the telemetry module.
+ * Used for consistent log categorization.
+ */
+export const TELEMETRY_LOG_COMPONENTS = {
+    /** SDK initialization component */
+    SDK: "TelemetrySDK",
+    /** Tracing utilities component */
+    TRACING: "Tracing",
+    /** Metrics manager component */
+    METRICS: "Metrics",
+    /** Configuration component */
+    CONFIG: "TelemetryConfig",
+};
+// ============================================================================
+// Log Messages
+// ============================================================================
+/**
+ * Centralized log messages for SDK lifecycle.
+ */
+export const SdkLogMessages = {
+    // Initialization
+    INIT_START: "Initializing OpenTelemetry SDK",
+    INIT_SUCCESS: "OpenTelemetry initialized: service=%s, endpoint=%s",
+    INIT_SKIPPED: "OpenTelemetry disabled - skipping initialization",
+    INIT_PACKAGES_MISSING: "OpenTelemetry packages not installed (%s). OTEL_ENABLED=true requires: npm install @opentelemetry/sdk-node @opentelemetry/sdk-metrics @opentelemetry/sdk-trace-base @opentelemetry/exporter-trace-otlp-http @opentelemetry/exporter-metrics-otlp-http @opentelemetry/exporter-prometheus @opentelemetry/instrumentation-http @opentelemetry/instrumentation-express @opentelemetry/resources @opentelemetry/semantic-conventions — disabling telemetry",
+    // Metric exporters
+    METRICS_EXPORTERS_CONFIGURED: "Metric exporters configured: %s",
+    PROMETHEUS_EXPORTER_ADDED: "Prometheus MetricReader added (embedded at /metrics)",
+    UNKNOWN_METRIC_EXPORTER: "Unknown metric exporter '%s' — ignored. Supported: otlp, prometheus, console, none",
+    // Trace exporter
+    TRACE_EXPORTER_CONFIGURED: "Trace exporter configured: %s",
+    UNKNOWN_TRACE_EXPORTER: "Unknown trace exporter '%s' — falling back to OTLP. Supported: otlp, console, none",
+    // Shutdown
+    SHUTDOWN_START: "Shutting down OpenTelemetry SDK",
+    SHUTDOWN_SUCCESS: "OpenTelemetry SDK shut down successfully",
+    SHUTDOWN_ERROR: "Error shutting down OpenTelemetry SDK: %s",
+    SHUTDOWN_SKIPPED: "OpenTelemetry SDK not initialized - nothing to shutdown",
+};
+// ============================================================================
+// Transport Type Constants
+// ============================================================================
+/**
+ * Known transport types for session tracking.
+ */
+export const TRANSPORT_TYPES = {
+    HTTP: "http",
+    SSE: "sse",
+    STDIO: "stdio",
+};
+//# sourceMappingURL=constants.js.map

package/build/telemetry/core/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/telemetry/core/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,2EAA2E;IAC3E,YAAY,EAAE,YAAY;IAC1B,iDAAiD;IACjD,wBAAwB,EAAE,SAAS;IACnC,+BAA+B;IAC/B,gBAAgB,EAAE,iBAAiB;IACnC,gEAAgE;IAChE,aAAa,EAAE,uBAAuB;CAC9B,CAAC;AAEX;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,oBAAoB;IACpB,6DAA6D;IAC7D,YAAY,EAAE,cAAc;IAC5B,iEAAiE;IACjE,iBAAiB,EAAE,mBAAmB;IACtC,0EAA0E;IAC1E,qBAAqB,EAAE,uBAAuB;IAE9C,+BAA+B;IAC/B,iCAAiC;IACjC,2BAA2B,EAAE,6BAA6B;IAC1D,+BAA+B;IAC/B,oBAAoB,EAAE,sBAAsB;IAC5C,0EAA0E;IAC1E,kBAAkB,EAAE,oBAAoB;IACxC,+BAA+B;IAC/B,cAAc,EAAE,gBAAgB;IAChC,2CAA2C;IAC3C,2BAA2B,EAAE,6BAA6B;CAClD,CAAC;AAEX,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,oBAAoB;IACpB,SAAS,EAAE,eAAe;IAC1B,uBAAuB;IACvB,YAAY,EAAE,kBAAkB;IAChC,gCAAgC;IAChC,iBAAiB,EAAE,uBAAuB;IAC1C,sBAAsB;IACtB,WAAW,EAAE,iBAAiB;IAC9B,qBAAqB;IACrB,UAAU,EAAE,gBAAgB;IAC5B,qBAAqB;IACrB,UAAU,EAAE,gBAAgB;IAC5B,iEAAiE;IACjE,SAAS,EAAE,eAAe;IAC1B,sCAAsC;IACtC,OAAO,EAAE,aAAa;IACtB,gCAAgC;IAChC,oBAAoB,EAAE,0BAA0B;IAChD,4CAA4C;IAC5C,eAAe,EAAE,qBAAqB;CAC9B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,8BAA8B;IAC9B,SAAS,EAAE,WAAW;IACtB,wCAAwC;IACxC,SAAS,EAAE,WAAW;IACtB,6BAA6B;IAC7B,OAAO,EAAE,SAAS;IAClB,iBAAiB;IACjB,UAAU,EAAE,YAAY;IACxB,qCAAqC;IACrC,SAAS,EAAE,WAAW;IACtB,gCAAgC;IAChC,cAAc,EAAE,2BAA2B;IAC3C,+BAA+B;IAC/B,aAAa,EAAE,0BAA0B;CACjC,CAAC;AAEX,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,iCAAiC;IACjC,cAAc,EAAE,qBAAqB;IACrC,qCAAqC;IACrC,gBAAgB,EAAE,6BAA6B;IAC/C,wCAAwC;IACxC,eAAe,EAAE,4BAA4B;IAC7C,2CAA2C;IAC3C,wBAAwB,EAAE,qCAAqC;IAC/D,yBAAyB;IACzB,YAAY,EAAE,mBAAmB;IACjC,8BAA8B;IAC9B,MAAM,EAAE,mBAAmB;IAC3B,iCAAiC;IACjC,gBAAgB,EAAE,6BAA6B;IAC/C,2BAA2B;IAC3B,UAAU,EAAE,uBAAuB;CAC3B,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,CAAC,YAAY,CAAC,cAAc,CAAC,EAAE,wCAAwC;IACvE,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,0CAA0C;IAC3E,CAAC,YAAY,CAAC,eAAe,CAAC,EAAE,2BAA2B;IAC3D,CAAC,YAAY,CAAC,wBAAwB,CAAC,EAAE,oCAAoC;IAC7E,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,wBAAwB;IACrD,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,0BAA0B;IACjD,CAAC,YAAY,CAAC,gBAAgB,CAAC,EAAE,2BAA2B;IAC5D,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,4BAA4B;CAC/C,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,KAAK,EAAE,GAAG;IACV,YAAY,EAAE,IAAI;IAClB,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,IAAI;CACH,CAAC;AAEX,+EAA+E;AAC/E,4BAA4B;AAC5B,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,mCAAmC;IACnC,GAAG,EAAE,cAAc;IACnB,kCAAkC;IAClC,OAAO,EAAE,SAAS;IAClB,gCAAgC;IAChC,OAAO,EAAE,SAAS;IAClB,8BAA8B;IAC9B,MAAM,EAAE,iBAAiB;CACjB,CAAC;AAEX,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,iBAAiB;IACjB,UAAU,EAAE,gCAAgC;IAC5C,YAAY,EAAE,oDAAoD;IAClE,YAAY,EAAE,kDAAkD;IAChE,qBAAqB,EACnB,wbAAwb;IAE1b,mBAAmB;IACnB,4BAA4B,EAAE,iCAAiC;IAC/D,yBAAyB,EAAE,sDAAsD;IACjF,uBAAuB,EAAE,oFAAoF;IAE7G,iBAAiB;IACjB,yBAAyB,EAAE,+BAA+B;IAC1D,sBAAsB,EAAE,oFAAoF;IAE5G,WAAW;IACX,cAAc,EAAE,iCAAiC;IACjD,gBAAgB,EAAE,0CAA0C;IAC5D,cAAc,EAAE,2CAA2C;IAC3D,gBAAgB,EAAE,yDAAyD;CACnE,CAAC;AAEX,+EAA+E;AAC/E,2BAA2B;AAC3B,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;CACN,CAAC"}

package/build/telemetry/core/diag-logger.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Framework Diagnostic Logger for OpenTelemetry
+ *
+ * Custom {@link DiagLogger} implementation that routes OpenTelemetry SDK
+ * diagnostic output through the framework's logging system instead of
+ * using the default {@link DiagConsoleLogger} which writes to stdout.
+ *
+ * ## Why not DiagConsoleLogger?
+ *
+ * 1. **Stdio-Transport Conflict**: MCP Stdio transport reserves stdout
+ *    for protocol data. DiagConsoleLogger writes INFO/DEBUG to stdout,
+ *    which corrupts the MCP message stream.
+ * 2. **Consistent Format**: Framework logger applies structured formatting
+ *    (text or JSON/ECS), secret scrubbing, and timestamp formatting.
+ * 3. **Unified Output**: All diagnostic output goes through stderr
+ *    (via the framework logger) regardless of transport mode.
+ *
+ * @module server/telemetry/core/diag-logger
+ */
+import type { DiagLogger } from "@opentelemetry/api";
+/**
+ * DiagLogger that delegates to the framework logger.
+ *
+ * Maps OTEL diagnostic levels to framework log levels:
+ * - `error()` → `logger.error()`
+ * - `warn()` → `logger.warn()`
+ * - `info()` → `logger.info()`
+ * - `debug()` → `logger.debug()`
+ * - `verbose()` → `logger.debug()` (framework has no verbose level)
+ *
+ * All output goes to stderr via the framework's writer pipeline,
+ * preventing stdout pollution that would break Stdio transport.
+ */
+export declare const frameworkDiagLogger: DiagLogger;
+//# sourceMappingURL=diag-logger.d.ts.map

package/build/telemetry/core/diag-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diag-logger.d.ts","sourceRoot":"","sources":["../../../src/telemetry/core/diag-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAOrD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAqBjC,CAAC"}

package/build/telemetry/core/diag-logger.js

@@ -0,0 +1,54 @@
+/**
+ * Framework Diagnostic Logger for OpenTelemetry
+ *
+ * Custom {@link DiagLogger} implementation that routes OpenTelemetry SDK
+ * diagnostic output through the framework's logging system instead of
+ * using the default {@link DiagConsoleLogger} which writes to stdout.
+ *
+ * ## Why not DiagConsoleLogger?
+ *
+ * 1. **Stdio-Transport Conflict**: MCP Stdio transport reserves stdout
+ *    for protocol data. DiagConsoleLogger writes INFO/DEBUG to stdout,
+ *    which corrupts the MCP message stream.
+ * 2. **Consistent Format**: Framework logger applies structured formatting
+ *    (text or JSON/ECS), secret scrubbing, and timestamp formatting.
+ * 3. **Unified Output**: All diagnostic output goes through stderr
+ *    (via the framework logger) regardless of transport mode.
+ *
+ * @module server/telemetry/core/diag-logger
+ */
+import { logger as baseLogger } from "../../logger/index.js";
+import { TELEMETRY_LOG_COMPONENTS } from "./constants.js";
+const logger = baseLogger.child({ component: TELEMETRY_LOG_COMPONENTS.SDK });
+/**
+ * DiagLogger that delegates to the framework logger.
+ *
+ * Maps OTEL diagnostic levels to framework log levels:
+ * - `error()` → `logger.error()`
+ * - `warn()` → `logger.warn()`
+ * - `info()` → `logger.info()`
+ * - `debug()` → `logger.debug()`
+ * - `verbose()` → `logger.debug()` (framework has no verbose level)
+ *
+ * All output goes to stderr via the framework's writer pipeline,
+ * preventing stdout pollution that would break Stdio transport.
+ */
+export const frameworkDiagLogger = {
+    error(message, ...args) {
+        logger.error(`[OTEL] ${message}`, ...args);
+    },
+    warn(message, ...args) {
+        logger.warn(`[OTEL] ${message}`, ...args);
+    },
+    info(message, ...args) {
+        logger.info(`[OTEL] ${message}`, ...args);
+    },
+    debug(message, ...args) {
+        logger.debug(`[OTEL] ${message}`, ...args);
+    },
+    verbose(message, ...args) {
+        // Framework logger has no 'verbose' level — map to trace
+        logger.trace(`[OTEL:verbose] ${message}`, ...args);
+    },
+};
+//# sourceMappingURL=diag-logger.js.map

package/build/telemetry/core/diag-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diag-logger.js","sourceRoot":"","sources":["../../../src/telemetry/core/diag-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,wBAAwB,CAAC,GAAG,EAAE,CAAC,CAAC;AAE7E;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,MAAM,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACtC,MAAM,CAAC,IAAI,CAAC,UAAU,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACvC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,CAAC,OAAe,EAAE,GAAG,IAAe;QACzC,yDAAyD;QACzD,MAAM,CAAC,KAAK,CAAC,kBAAkB,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;CACF,CAAC"}

package/build/telemetry/core/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Telemetry Core Module
+ *
+ * Barrel export for centralized types, constants, and configuration.
+ *
+ * @module server/telemetry/core
+ */
+export type { TelemetryConfig, SpanOptions, TraceContext, SpanCallback, AsyncSpanCallback, ServerMetrics, ServerStats, Span, Attributes, Context, SpanKind, } from "./types.js";
+export { TELEMETRY_DEFAULTS, TELEMETRY_ENV_VARS, MCP_ATTRIBUTES, METRIC_ATTRIBUTES, METRIC_NAMES, METRIC_DESCRIPTIONS, METRIC_UNITS, TELEMETRY_LOG_COMPONENTS, SdkLogMessages, TRANSPORT_TYPES, } from "./constants.js";
+export { getTelemetryConfig, isTelemetryEnabled } from "./config.js";
+export { frameworkDiagLogger } from "./diag-logger.js";
+//# sourceMappingURL=index.d.ts.map

package/build/telemetry/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,YAAY,EAEV,eAAe,EAEf,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,iBAAiB,EAEjB,aAAa,EACb,WAAW,EAEX,IAAI,EACJ,UAAU,EACV,OAAO,EACP,QAAQ,GACT,MAAM,YAAY,CAAC;AAMpB,OAAO,EAEL,kBAAkB,EAClB,kBAAkB,EAElB,cAAc,EACd,iBAAiB,EAEjB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EAEZ,wBAAwB,EAExB,cAAc,EAEd,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAMxB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/build/telemetry/core/index.js

@@ -0,0 +1,32 @@
+/**
+ * Telemetry Core Module
+ *
+ * Barrel export for centralized types, constants, and configuration.
+ *
+ * @module server/telemetry/core
+ */
+// ============================================================================
+// Constants
+// ============================================================================
+export { 
+// Configuration
+TELEMETRY_DEFAULTS, TELEMETRY_ENV_VARS, 
+// Semantic Attributes
+MCP_ATTRIBUTES, METRIC_ATTRIBUTES, 
+// Metric Names
+METRIC_NAMES, METRIC_DESCRIPTIONS, METRIC_UNITS, 
+// Log Components
+TELEMETRY_LOG_COMPONENTS, 
+// Log Messages
+SdkLogMessages, 
+// Transport Types
+TRANSPORT_TYPES, } from "./constants.js";
+// ============================================================================
+// Configuration
+// ============================================================================
+export { getTelemetryConfig, isTelemetryEnabled } from "./config.js";
+// ============================================================================
+// DiagLogger
+// ============================================================================
+export { frameworkDiagLogger } from "./diag-logger.js";
+//# sourceMappingURL=index.js.map

package/build/telemetry/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/telemetry/core/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwBH,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E,OAAO;AACL,gBAAgB;AAChB,kBAAkB,EAClB,kBAAkB;AAClB,sBAAsB;AACtB,cAAc,EACd,iBAAiB;AACjB,eAAe;AACf,YAAY,EACZ,mBAAmB,EACnB,YAAY;AACZ,iBAAiB;AACjB,wBAAwB;AACxB,eAAe;AACf,cAAc;AACd,kBAAkB;AAClB,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAErE,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC"}

package/build/telemetry/core/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Telemetry Module Types
+ *
+ * Centralized type definitions for the OpenTelemetry integration module.
+ * Includes configuration, tracing, and metrics types.
+ *
+ * @module server/telemetry/core/types
+ */
+import type { Span, SpanKind, Attributes, Context } from "@opentelemetry/api";
+/**
+ * OpenTelemetry configuration options.
+ *
+ * Contains both framework-managed settings and standard OTEL settings
+ * that are passed through the config system for unified configuration.
+ */
+export interface TelemetryConfig {
+    /** Whether OpenTelemetry is enabled */
+    readonly enabled: boolean;
+    /** Service name for traces and metrics */
+    readonly serviceName: string;
+    /** Service version */
+    readonly serviceVersion: string;
+    /** OTLP exporter endpoint URL. Defaults to OTEL standard: http://localhost:4318 */
+    readonly endpoint: string;
+    /** Trace exporter: 'otlp', 'console', 'none' */
+    readonly tracesExporter?: string | undefined;
+    /** Log exporter: 'otlp', 'console', 'none'. Default: 'none' (framework uses own logger) */
+    readonly logsExporter: string;
+    /** SDK diagnostic log level: 'NONE', 'ERROR', 'WARN', 'INFO', 'DEBUG', 'VERBOSE', 'ALL' */
+    readonly logLevel?: string | undefined;
+    /** Periodic metric export interval in milliseconds */
+    readonly metricExportInterval?: number | undefined;
+    /**
+     * Active metric exporters (parsed from OTEL_METRICS_EXPORTER).
+     * Supported values: 'otlp', 'prometheus', 'console', 'none'.
+     */
+    readonly metricsExporters: readonly string[];
+}
+/**
+ * Options for creating a span.
+ */
+export interface SpanOptions {
+    /** Span kind (default: INTERNAL) */
+    kind?: SpanKind;
+    /** Initial attributes */
+    attributes?: Attributes;
+    /** Parent context (uses active context if not provided) */
+    parentContext?: Context;
+}
+/**
+ * Trace context for propagation to external services.
+ */
+export interface TraceContext {
+    /** Trace ID */
+    readonly traceId: string;
+    /** Span ID */
+    readonly spanId: string;
+}
+/**
+ * Function signature for span execution callback.
+ */
+export type SpanCallback<T> = (span: Span) => T;
+/**
+ * Function signature for async span execution callback.
+ */
+export type AsyncSpanCallback<T> = (span: Span) => Promise<T>;
+/**
+ * Server metrics interface for type-safe metric recording.
+ */
+export interface ServerMetrics {
+    /** Record a request (tool invocation) */
+    recordRequest(toolName: string, durationMs: number, success: boolean): void;
+    /** Record an active session change */
+    recordSessionChange(transport: string, delta: number): void;
+    /** Record a connection state change */
+    recordConnectionStateChange(previousState: string, newState: string): void;
+    /** Record an error */
+    recordError(errorType: string, component: string): void;
+    /** Get current server stats */
+    getStats(): ServerStats;
+}
+/**
+ * Server statistics snapshot.
+ */
+export interface ServerStats {
+    /** Server uptime in milliseconds */
+    readonly uptimeMs: number;
+    /** Server start time */
+    readonly startTime: Date;
+    /** Total requests processed */
+    readonly totalRequests: number;
+    /** Failed requests */
+    readonly failedRequests: number;
+    /** Active HTTP sessions */
+    readonly activeHttpSessions: number;
+    /** Active SSE sessions */
+    readonly activeSseSessions: number;
+    /** Connection state changes count */
+    readonly connectionStateChanges: number;
+    /** Current memory usage in bytes */
+    readonly memoryUsageBytes: number;
+    /** Current heap used in bytes */
+    readonly heapUsedBytes: number;
+}
+export type { Span, SpanKind, Attributes, Context } from "@opentelemetry/api";
+//# sourceMappingURL=types.d.ts.map

package/build/telemetry/core/types.d.ts.map

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

package/build/telemetry/core/types.js

@@ -0,0 +1,10 @@
+/**
+ * Telemetry Module Types
+ *
+ * Centralized type definitions for the OpenTelemetry integration module.
+ * Includes configuration, tracing, and metrics types.
+ *
+ * @module server/telemetry/core/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/build/telemetry/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/telemetry/core/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/build/telemetry/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Telemetry Module
+ *
+ * OpenTelemetry integration for distributed tracing and metrics.
+ *
+ * ## Setup
+ *
+ * Enable telemetry with environment variables:
+ * ```bash
+ * OTEL_ENABLED=true
+ * OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
+ * ```
+ *
+ * All OTEL settings are routed through the config system (env vars + config file):
+ * - `OTEL_EXPORTER_OTLP_ENDPOINT` — OTLP endpoint URL
+ * - `OTEL_TRACES_EXPORTER` — Trace exporter: otlp (default), console, none
+ * - `OTEL_LOG_LEVEL` — SDK diagnostic log level
+ * - `OTEL_METRIC_EXPORT_INTERVAL` — Metric export interval (ms)
+ *
+ * Framework-managed env vars:
+ * - `OTEL_METRICS_EXPORTER` — otlp, prometheus, console, none (default: otlp,prometheus)
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { initializeTelemetry, withSpan, getTraceContext, serverMetrics } from './telemetry/index.js';
+ *
+ * // Initialize at startup
+ * initializeTelemetry();
+ *
+ * // Create spans
+ * await withSpan('myOperation', async (span) => {
+ *   span.setAttribute('key', 'value');
+ *   return await doSomething();
+ * });
+ *
+ * // Get trace context for propagation
+ * const ctx = getTraceContext();
+ *
+ * // Record metrics
+ * serverMetrics.recordRequest('tool_name', 150, true);
+ * ```
+ *
+ * @module server/telemetry
+ */
+export { initializeTelemetry, shutdownTelemetry, isSdkInitialized, getPrometheusExporter } from "./sdk.js";
+export { getTelemetryConfig, isTelemetryEnabled } from "./core/index.js";
+export type { TelemetryConfig } from "./core/index.js";
+export { getTracer, withSpan, withSpanSync, getActiveSpan, addSpanAttributes, addSpanEvent, getTraceContext, FrameworkSpanKind, FrameworkSpanStatusCode, } from "./tracing.js";
+export { MCP_ATTRIBUTES } from "./core/index.js";
+export type { SpanOptions, TraceContext, SpanCallback, AsyncSpanCallback } from "./core/index.js";
+export { ServerMetricsManager, createServerMetrics, getServerMetrics, resetServerMetrics } from "./metrics.js";
+export { METRIC_ATTRIBUTES } from "./core/index.js";
+export type { ServerMetrics, ServerStats } from "./core/index.js";
+export { TELEMETRY_DEFAULTS, TELEMETRY_ENV_VARS, METRIC_NAMES, METRIC_DESCRIPTIONS, METRIC_UNITS, TRANSPORT_TYPES, TELEMETRY_LOG_COMPONENTS, SdkLogMessages, } from "./core/index.js";
+export { FrameworkSpanKind as SpanKind, FrameworkSpanStatusCode as SpanStatusCode } from "./tracing.js";
+export type { Span, Attributes, Context, Tracer } from "@opentelemetry/api";
+export { createConnectionTelemetry } from "./connection-telemetry-bridge.js";
+//# sourceMappingURL=index.d.ts.map

package/build/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAMH,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAM3G,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAMvD,OAAO,EACL,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMlG,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAMlE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,wBAAwB,EACxB,cAAc,GACf,MAAM,iBAAiB,CAAC;AASzB,OAAO,EAAE,iBAAiB,IAAI,QAAQ,EAAE,uBAAuB,IAAI,cAAc,EAAE,MAAM,cAAc,CAAC;AACxG,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAM5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC"}

package/build/telemetry/index.js

@@ -0,0 +1,79 @@
+/**
+ * Telemetry Module
+ *
+ * OpenTelemetry integration for distributed tracing and metrics.
+ *
+ * ## Setup
+ *
+ * Enable telemetry with environment variables:
+ * ```bash
+ * OTEL_ENABLED=true
+ * OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
+ * ```
+ *
+ * All OTEL settings are routed through the config system (env vars + config file):
+ * - `OTEL_EXPORTER_OTLP_ENDPOINT` — OTLP endpoint URL
+ * - `OTEL_TRACES_EXPORTER` — Trace exporter: otlp (default), console, none
+ * - `OTEL_LOG_LEVEL` — SDK diagnostic log level
+ * - `OTEL_METRIC_EXPORT_INTERVAL` — Metric export interval (ms)
+ *
+ * Framework-managed env vars:
+ * - `OTEL_METRICS_EXPORTER` — otlp, prometheus, console, none (default: otlp,prometheus)
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { initializeTelemetry, withSpan, getTraceContext, serverMetrics } from './telemetry/index.js';
+ *
+ * // Initialize at startup
+ * initializeTelemetry();
+ *
+ * // Create spans
+ * await withSpan('myOperation', async (span) => {
+ *   span.setAttribute('key', 'value');
+ *   return await doSomething();
+ * });
+ *
+ * // Get trace context for propagation
+ * const ctx = getTraceContext();
+ *
+ * // Record metrics
+ * serverMetrics.recordRequest('tool_name', 150, true);
+ * ```
+ *
+ * @module server/telemetry
+ */
+// ============================================================================
+// SDK Lifecycle
+// ============================================================================
+export { initializeTelemetry, shutdownTelemetry, isSdkInitialized, getPrometheusExporter } from "./sdk.js";
+// ============================================================================
+// Configuration
+// ============================================================================
+export { getTelemetryConfig, isTelemetryEnabled } from "./core/index.js";
+// ============================================================================
+// Tracing
+// ============================================================================
+export { getTracer, withSpan, withSpanSync, getActiveSpan, addSpanAttributes, addSpanEvent, getTraceContext, FrameworkSpanKind, FrameworkSpanStatusCode, } from "./tracing.js";
+export { MCP_ATTRIBUTES } from "./core/index.js";
+// ============================================================================
+// Metrics
+// ============================================================================
+export { ServerMetricsManager, createServerMetrics, getServerMetrics, resetServerMetrics } from "./metrics.js";
+export { METRIC_ATTRIBUTES } from "./core/index.js";
+// ============================================================================
+// Constants (for advanced usage)
+// ============================================================================
+export { TELEMETRY_DEFAULTS, TELEMETRY_ENV_VARS, METRIC_NAMES, METRIC_DESCRIPTIONS, METRIC_UNITS, TRANSPORT_TYPES, TELEMETRY_LOG_COMPONENTS, SdkLogMessages, } from "./core/index.js";
+// ============================================================================
+// OpenTelemetry-compatible Re-exports (framework-level, no static OTEL import)
+// ============================================================================
+// SpanKind & SpanStatusCode are re-exported as FrameworkSpanKind / FrameworkSpanStatusCode
+// from tracing.js above. For backward-compat, provide aliases with the original names.
+// Type-only re-exports remain zero-cost.
+export { FrameworkSpanKind as SpanKind, FrameworkSpanStatusCode as SpanStatusCode } from "./tracing.js";
+// ============================================================================
+// Connection Telemetry Bridge
+// ============================================================================
+export { createConnectionTelemetry } from "./connection-telemetry-bridge.js";
+//# sourceMappingURL=index.js.map

package/build/telemetry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAE3G,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGzE,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,OAAO,EACL,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,eAAe,EACf,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAC/G,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,+EAA+E;AAC/E,iCAAiC;AACjC,+EAA+E;AAE/E,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,YAAY,EACZ,eAAe,EACf,wBAAwB,EACxB,cAAc,GACf,MAAM,iBAAiB,CAAC;AAEzB,+EAA+E;AAC/E,+EAA+E;AAC/E,+EAA+E;AAE/E,2FAA2F;AAC3F,uFAAuF;AACvF,yCAAyC;AACzC,OAAO,EAAE,iBAAiB,IAAI,QAAQ,EAAE,uBAAuB,IAAI,cAAc,EAAE,MAAM,cAAc,CAAC;AAGxG,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC"}