@iii-dev/observability 0.16.1 → 0.16.2-next.1

package/dist/index.mjs

@@ -1,1062 +1,8 @@
-import { SeverityNumber, SeverityNumber as SeverityNumber$1 } from "@opentelemetry/api-logs";
-import { Resource } from "@opentelemetry/resources";
-import { ATTR_SERVICE_NAME } from "@opentelemetry/semantic-conventions";
-import { randomUUID } from "node:crypto";
-import { SpanKind, SpanKind as SpanKind$1, SpanStatusCode, SpanStatusCode as SpanStatusCode$1, context, metrics, propagation, trace } from "@opentelemetry/api";
-import { BatchSpanProcessor } from "@opentelemetry/sdk-trace-base";
-import { MeterProvider, PeriodicExportingMetricReader } from "@opentelemetry/sdk-metrics";
-import { CompositePropagator, ExportResultCode, W3CBaggagePropagator, W3CTraceContextPropagator } from "@opentelemetry/core";
-import { NodeTracerProvider } from "@opentelemetry/sdk-trace-node";
-import { registerInstrumentations } from "@opentelemetry/instrumentation";
-import { BatchLogRecordProcessor, LoggerProvider } from "@opentelemetry/sdk-logs";
-import { WebSocket } from "ws";
-import { JsonLogsSerializer, JsonMetricsSerializer, JsonTraceSerializer } from "@opentelemetry/otlp-transformer";
+import { A as BaggageSpanProcessor, C as extractTraceparent, D as injectTraceparent, E as injectBaggage, O as removeBaggageEntry, S as extractContext, T as getBaggageEntry, _ as patchGlobalFetch, b as currentTraceId, c as withSpan, d as redactAndTruncate, f as resolveMaxBytesFromEnv, g as setCurrentSpanError, h as setCurrentSpanAttribute, j as DEFAULT_ALLOWLIST, k as setBaggageEntry, l as REDACTED_PLACEHOLDER, m as recordSpanEvent, n as flushOtel, o as initOtel, p as currentSpanIsRecording, r as getLogger, s as shutdownOtel, t as SeverityNumber, u as redact, v as unpatchGlobalFetch, w as getAllBaggage, x as extractBaggage, y as currentSpanId } from "./telemetry-system-B84W8JWm.mjs";
+import { SeverityNumber as SeverityNumber$1 } from "@opentelemetry/api-logs";
+import { SpanKind, SpanStatusCode, context, propagation, trace } from "@opentelemetry/api";
 import { monitorEventLoopDelay, performance } from "node:perf_hooks";
 
-//#region src/telemetry-system/baggage-span-processor.ts
-/** DEFAULT_ALLOWLIST drift across languages would break worker chains;
-* lockstep tests in each SDK pin this constant at CI time. */
-const DEFAULT_ALLOWLIST = [
-	"iii.session.id",
-	"iii.message.id",
-	"iii.function.id"
-];
-var BaggageSpanProcessor = class {
-	allowlist;
-	constructor(allowlist = DEFAULT_ALLOWLIST) {
-		this.allowlist = allowlist;
-	}
-	onStart(span, parentContext) {
-		if (!span.isRecording()) return;
-		const baggage = propagation.getBaggage(parentContext);
-		if (!baggage) return;
-		for (const key of this.allowlist) {
-			const entry = baggage.getEntry(key);
-			if (entry) span.setAttribute(key, entry.value);
-		}
-	}
-	onEnd(_span) {}
-	async shutdown() {}
-	async forceFlush() {}
-};
-
-//#endregion
-//#region src/telemetry-system/types.ts
-const ATTR_SERVICE_VERSION = "service.version";
-const ATTR_SERVICE_NAMESPACE = "service.namespace";
-const ATTR_SERVICE_INSTANCE_ID = "service.instance.id";
-/** Magic prefixes for binary frames over WebSocket */
-const PREFIX_TRACES = "OTLP";
-const PREFIX_METRICS = "MTRC";
-const PREFIX_LOGS = "LOGS";
-/** Default reconnection configuration */
-const DEFAULT_RECONNECTION_CONFIG = {
-	initialDelayMs: 1e3,
-	maxDelayMs: 3e4,
-	backoffMultiplier: 2,
-	jitterFactor: .3,
-	maxRetries: -1
-};
-/** Default configuration values for OpenTelemetry initialization. */
-const DEFAULT_OTEL_CONFIG = {
-	enabled: true,
-	serviceName: "iii-node",
-	serviceVersion: "unknown",
-	engineWsUrl: "ws://localhost:49134",
-	metricsEnabled: true,
-	metricsExportIntervalMs: 6e4,
-	logsFlushIntervalMs: 100,
-	logsBatchSize: 1,
-	fetchInstrumentationEnabled: true
-};
-/** Parse a boolean environment variable, recognizing 'false', '0', 'no', 'off' as false. */
-function parseBoolEnv(value, defaultValue) {
-	if (value === void 0) return defaultValue;
-	const lower = value.toLowerCase();
-	return lower !== "false" && lower !== "0" && lower !== "no" && lower !== "off";
-}
-
-//#endregion
-//#region src/telemetry-system/connection.ts
-/**
-* Shared WebSocket connection for OpenTelemetry exporters.
-*/
-/**
-* Shared WebSocket connection for all OTEL exporters (traces, metrics, logs).
-* Uses a single connection with message prefixes to identify signal type.
-*/
-var SharedEngineConnection = class SharedEngineConnection {
-	static MAX_PENDING_MESSAGES = 1e3;
-	ws = null;
-	wsUrl;
-	connecting = false;
-	shuttingDown = false;
-	pendingMessages = [];
-	reconnectAttempt = 0;
-	reconnectTimeout = null;
-	config;
-	state = "disconnected";
-	onConnectedCallbacks = [];
-	onFailedCallbacks = [];
-	constructor(wsUrl, config = {}) {
-		this.wsUrl = wsUrl;
-		this.config = {
-			...DEFAULT_RECONNECTION_CONFIG,
-			...config
-		};
-		this.connect();
-	}
-	connect() {
-		if (this.connecting || this.ws && this.ws.readyState === WebSocket.OPEN) return;
-		this.connecting = true;
-		this.state = "connecting";
-		try {
-			this.ws = new WebSocket(this.wsUrl);
-			this.ws.on("open", () => {
-				this.connecting = false;
-				this.state = "connected";
-				console.log(`[OTel] Connected to engine at ${this.wsUrl}`);
-				if (this.reconnectAttempt > 0) console.log("[OTel] Successfully reconnected");
-				this.reconnectAttempt = 0;
-				if (this.reconnectTimeout) {
-					clearTimeout(this.reconnectTimeout);
-					this.reconnectTimeout = null;
-				}
-				const pending = this.pendingMessages.splice(0, this.pendingMessages.length);
-				for (const { frame, callback } of pending) this.ws?.send(frame, (err) => callback?.(err));
-				for (const cb of this.onConnectedCallbacks) cb();
-			});
-			this.ws.on("close", () => {
-				this.connecting = false;
-				this.ws = null;
-				if (this.shuttingDown) {
-					this.state = "disconnected";
-					console.log("[OTel] Connection closed during shutdown");
-					return;
-				}
-				this.state = "disconnected";
-				console.log("[OTel] Disconnected from engine, will reconnect...");
-				this.scheduleReconnect();
-			});
-			this.ws.on("error", (err) => {
-				this.connecting = false;
-				if (this.shuttingDown) return;
-				console.error("[OTel] WebSocket error:", err.message);
-			});
-		} catch (err) {
-			this.connecting = false;
-			console.error("[OTel] Connection failed:", err);
-			this.scheduleReconnect();
-		}
-	}
-	scheduleReconnect() {
-		if (this.config.maxRetries !== -1 && this.reconnectAttempt >= this.config.maxRetries) {
-			this.state = "failed";
-			console.error(`[OTel] Max retries (${this.config.maxRetries}) reached, giving up`);
-			const pending = this.pendingMessages.splice(0, this.pendingMessages.length);
-			const failedError = /* @__PURE__ */ new Error("Connection failed after max retries");
-			for (const { callback } of pending) callback?.(failedError);
-			for (const cb of this.onFailedCallbacks) try {
-				cb();
-			} catch (err) {
-				console.error("[OTel] onFailed callback threw:", err);
-			}
-			return;
-		}
-		if (this.reconnectTimeout) return;
-		const exponentialDelay = this.config.initialDelayMs * this.config.backoffMultiplier ** this.reconnectAttempt;
-		const cappedDelay = Math.min(exponentialDelay, this.config.maxDelayMs);
-		const jitter = cappedDelay * this.config.jitterFactor * (2 * Math.random() - 1);
-		const delay = Math.max(0, Math.floor(cappedDelay + jitter));
-		this.state = "reconnecting";
-		console.log(`[OTel] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempt + 1})...`);
-		this.reconnectTimeout = setTimeout(() => {
-			this.reconnectTimeout = null;
-			this.reconnectAttempt++;
-			this.connect();
-		}, delay);
-	}
-	/**
-	* Send a message with a signal prefix.
-	*/
-	send(prefix, data, callback) {
-		const prefixBytes = Buffer.from(prefix, "utf-8");
-		const frame = Buffer.concat([prefixBytes, Buffer.from(data)]);
-		if (this.ws && this.ws.readyState === WebSocket.OPEN) this.ws.send(frame, callback);
-		else {
-			if (this.pendingMessages.length >= SharedEngineConnection.MAX_PENDING_MESSAGES) {
-				console.warn("[OTel] Pending message queue full, dropping oldest message");
-				this.pendingMessages.shift()?.callback?.(/* @__PURE__ */ new Error("Message dropped due to queue overflow"));
-			}
-			this.pendingMessages.push({
-				frame,
-				callback
-			});
-			this.connect();
-		}
-	}
-	/**
-	* Register a callback to be called when connected.
-	*/
-	onConnected(callback) {
-		this.onConnectedCallbacks.push(callback);
-		if (this.state === "connected") callback();
-	}
-	/**
-	* Register a callback to be called when the connection enters the failed
-	* terminal state (max retries reached). Exporters use this to drain their
-	* own pending queues so in-flight forceFlush() calls do not hang.
-	*/
-	onFailed(callback) {
-		this.onFailedCallbacks.push(callback);
-		if (this.state === "failed") try {
-			callback();
-		} catch (err) {
-			console.error("[OTel] onFailed callback threw:", err);
-		}
-	}
-	/**
-	* Get the current connection state.
-	*/
-	getState() {
-		return this.state;
-	}
-	/**
-	* Shutdown the connection.
-	*/
-	async shutdown() {
-		this.shuttingDown = true;
-		if (this.reconnectTimeout) {
-			clearTimeout(this.reconnectTimeout);
-			this.reconnectTimeout = null;
-		}
-		if (this.ws) {
-			this.ws.close();
-			this.ws = null;
-		}
-		const pending = this.pendingMessages.splice(0, this.pendingMessages.length);
-		const shutdownError = /* @__PURE__ */ new Error("Connection shutdown before message could be sent");
-		for (const { callback } of pending) callback?.(shutdownError);
-		this.onConnectedCallbacks = [];
-		this.onFailedCallbacks = [];
-		this.state = "disconnected";
-	}
-};
-
-//#endregion
-//#region src/telemetry-system/span-exporter.ts
-/**
-* Span exporter for the III Engine.
-*/
-/**
-* Span exporter using the shared WebSocket connection.
-*/
-var EngineSpanExporter = class EngineSpanExporter {
-	static MAX_PENDING_EXPORTS = 100;
-	connection;
-	pendingExports = [];
-	constructor(connection) {
-		this.connection = connection;
-		this.connection.onConnected(() => this.flushPending());
-		this.connection.onFailed(() => this.failPending());
-	}
-	flushPending() {
-		const pending = this.pendingExports.splice(0, this.pendingExports.length);
-		for (const { spans, resultCallback } of pending) this.sendExport(spans, resultCallback);
-	}
-	failPending() {
-		const pending = this.pendingExports.splice(0, this.pendingExports.length);
-		const error = /* @__PURE__ */ new Error("Connection failed: dropping queued spans");
-		for (const { resultCallback } of pending) resultCallback?.({
-			code: ExportResultCode.FAILED,
-			error
-		});
-	}
-	sendExport(spans, resultCallback) {
-		try {
-			const serialized = JsonTraceSerializer.serializeRequest(spans);
-			if (!serialized) {
-				resultCallback?.({ code: ExportResultCode.SUCCESS });
-				return;
-			}
-			this.connection.send(PREFIX_TRACES, serialized, (err) => {
-				if (err) {
-					console.error("[OTel] Failed to send spans:", err.message);
-					resultCallback?.({
-						code: ExportResultCode.FAILED,
-						error: err
-					});
-				} else resultCallback?.({ code: ExportResultCode.SUCCESS });
-			});
-		} catch (err) {
-			console.error("[OTel] Error exporting spans:", err);
-			resultCallback?.({
-				code: ExportResultCode.FAILED,
-				error: err
-			});
-		}
-	}
-	doExport(spans, resultCallback) {
-		const state = this.connection.getState();
-		if (state === "failed") {
-			resultCallback({
-				code: ExportResultCode.FAILED,
-				error: /* @__PURE__ */ new Error("Connection failed: dropping spans")
-			});
-			return;
-		}
-		if (state !== "connected") {
-			if (this.pendingExports.length >= EngineSpanExporter.MAX_PENDING_EXPORTS) {
-				this.pendingExports.shift()?.resultCallback?.({
-					code: ExportResultCode.FAILED,
-					error: /* @__PURE__ */ new Error("Queue overflow")
-				});
-				console.warn("[OTel] Spans export queue full, dropped oldest entry");
-			}
-			this.pendingExports.push({
-				spans,
-				resultCallback
-			});
-			return;
-		}
-		this.sendExport(spans, resultCallback);
-	}
-	export(spans, resultCallback) {
-		this.doExport(spans, resultCallback);
-	}
-	async shutdown() {
-		const pending = this.pendingExports.splice(0, this.pendingExports.length);
-		const shutdownError = /* @__PURE__ */ new Error("Exporter shutdown before export completed");
-		for (const { resultCallback } of pending) resultCallback?.({
-			code: ExportResultCode.FAILED,
-			error: shutdownError
-		});
-	}
-	async forceFlush() {}
-};
-
-//#endregion
-//#region src/telemetry-system/metrics-exporter.ts
-/**
-* Metrics exporter for the III Engine.
-*/
-/**
-* Metrics exporter using the shared WebSocket connection.
-*/
-var EngineMetricsExporter = class EngineMetricsExporter {
-	static MAX_PENDING_EXPORTS = 100;
-	connection;
-	pendingExports = [];
-	constructor(connection) {
-		this.connection = connection;
-		this.connection.onConnected(() => this.flushPending());
-		this.connection.onFailed(() => this.failPending());
-	}
-	flushPending() {
-		const pending = this.pendingExports.splice(0, this.pendingExports.length);
-		for (const { metrics, resultCallback } of pending) this.sendExport(metrics, resultCallback);
-	}
-	failPending() {
-		const pending = this.pendingExports.splice(0, this.pendingExports.length);
-		const error = /* @__PURE__ */ new Error("Connection failed: dropping queued metrics");
-		for (const { resultCallback } of pending) resultCallback?.({
-			code: ExportResultCode.FAILED,
-			error
-		});
-	}
-	sendExport(metricsData, resultCallback) {
-		try {
-			const serialized = JsonMetricsSerializer.serializeRequest(metricsData);
-			if (!serialized) {
-				resultCallback?.({ code: ExportResultCode.SUCCESS });
-				return;
-			}
-			this.connection.send(PREFIX_METRICS, serialized, (err) => {
-				if (err) {
-					console.error("[OTel] Failed to send metrics:", err.message);
-					resultCallback?.({
-						code: ExportResultCode.FAILED,
-						error: err
-					});
-				} else resultCallback?.({ code: ExportResultCode.SUCCESS });
-			});
-		} catch (err) {
-			console.error("[OTel] Error exporting metrics:", err);
-			resultCallback?.({
-				code: ExportResultCode.FAILED,
-				error: err
-			});
-		}
-	}
-	doExport(metricsData, resultCallback) {
-		const state = this.connection.getState();
-		if (state === "failed") {
-			resultCallback({
-				code: ExportResultCode.FAILED,
-				error: /* @__PURE__ */ new Error("Connection failed: dropping metrics")
-			});
-			return;
-		}
-		if (state !== "connected") {
-			if (this.pendingExports.length >= EngineMetricsExporter.MAX_PENDING_EXPORTS) {
-				this.pendingExports.shift()?.resultCallback?.({
-					code: ExportResultCode.FAILED,
-					error: /* @__PURE__ */ new Error("Queue overflow")
-				});
-				console.warn("[OTel] Metrics export queue full, dropped oldest entry");
-			}
-			this.pendingExports.push({
-				metrics: metricsData,
-				resultCallback
-			});
-			return;
-		}
-		this.sendExport(metricsData, resultCallback);
-	}
-	export(metrics, resultCallback) {
-		this.doExport(metrics, resultCallback);
-	}
-	async shutdown() {
-		const pending = this.pendingExports.splice(0, this.pendingExports.length);
-		const shutdownError = /* @__PURE__ */ new Error("Exporter shutdown before export completed");
-		for (const { resultCallback } of pending) resultCallback?.({
-			code: ExportResultCode.FAILED,
-			error: shutdownError
-		});
-	}
-	async forceFlush() {}
-};
-
-//#endregion
-//#region src/telemetry-system/log-exporter.ts
-/**
-* Log exporter for the III Engine.
-*/
-/**
-* Log exporter using the shared WebSocket connection.
-*/
-var EngineLogExporter = class EngineLogExporter {
-	static MAX_PENDING_EXPORTS = 100;
-	connection;
-	pendingExports = [];
-	constructor(connection) {
-		this.connection = connection;
-		this.connection.onConnected(() => this.flushPending());
-		this.connection.onFailed(() => this.failPending());
-	}
-	flushPending() {
-		const pending = this.pendingExports.splice(0, this.pendingExports.length);
-		for (const { logs, callback } of pending) this.doExport(logs, callback);
-	}
-	failPending() {
-		const pending = this.pendingExports.splice(0, this.pendingExports.length);
-		const error = /* @__PURE__ */ new Error("Connection failed: dropping queued logs");
-		for (const { callback } of pending) callback({
-			code: ExportResultCode.FAILED,
-			error
-		});
-	}
-	doExport(logs, resultCallback) {
-		const state = this.connection.getState();
-		if (state === "failed") {
-			resultCallback({
-				code: ExportResultCode.FAILED,
-				error: /* @__PURE__ */ new Error("Connection failed: dropping logs")
-			});
-			return;
-		}
-		if (state !== "connected") {
-			if (this.pendingExports.length >= EngineLogExporter.MAX_PENDING_EXPORTS) {
-				this.pendingExports.shift()?.callback({
-					code: ExportResultCode.FAILED,
-					error: /* @__PURE__ */ new Error("Logs export queue full")
-				});
-				console.warn("[OTel] Logs export queue full, dropped oldest entry");
-			}
-			this.pendingExports.push({
-				logs,
-				callback: resultCallback
-			});
-			return;
-		}
-		try {
-			const serialized = JsonLogsSerializer.serializeRequest(logs);
-			if (!serialized) {
-				resultCallback({ code: ExportResultCode.SUCCESS });
-				return;
-			}
-			this.connection.send(PREFIX_LOGS, serialized, (err) => {
-				if (err) {
-					console.error("[OTel] Failed to send logs:", err.message);
-					resultCallback({
-						code: ExportResultCode.FAILED,
-						error: err
-					});
-				} else resultCallback({ code: ExportResultCode.SUCCESS });
-			});
-		} catch (err) {
-			console.error("[OTel] Error exporting logs:", err);
-			resultCallback({
-				code: ExportResultCode.FAILED,
-				error: err
-			});
-		}
-	}
-	export(logs, resultCallback) {
-		this.doExport(logs, resultCallback);
-	}
-	async forceFlush() {}
-	async shutdown() {
-		for (const { callback } of this.pendingExports) callback({
-			code: ExportResultCode.FAILED,
-			error: /* @__PURE__ */ new Error("Exporter shutdown")
-		});
-		this.pendingExports = [];
-	}
-};
-
-//#endregion
-//#region src/telemetry-system/context.ts
-/**
-* Trace context and baggage propagation utilities.
-*/
-/**
-* Extract the current trace ID from the active span context.
-*/
-function currentTraceId() {
-	const span = trace.getActiveSpan();
-	if (span) {
-		const spanContext = span.spanContext();
-		if (spanContext.traceId && spanContext.traceId !== "00000000000000000000000000000000") return spanContext.traceId;
-	}
-}
-/**
-* Extract the current span ID from the active span context.
-*/
-function currentSpanId() {
-	const span = trace.getActiveSpan();
-	if (span) {
-		const spanContext = span.spanContext();
-		if (spanContext.spanId && spanContext.spanId !== "0000000000000000") return spanContext.spanId;
-	}
-}
-/**
-* Inject the current trace context into a W3C traceparent header string.
-*/
-function injectTraceparent() {
-	const carrier = {};
-	propagation.inject(context.active(), carrier);
-	return carrier.traceparent;
-}
-/**
-* Extract a trace context from a W3C traceparent header string.
-*/
-function extractTraceparent(traceparent) {
-	const carrier = { traceparent };
-	return propagation.extract(context.active(), carrier);
-}
-/**
-* Inject the current baggage into a W3C baggage header string.
-*/
-function injectBaggage() {
-	const carrier = {};
-	propagation.inject(context.active(), carrier);
-	return carrier.baggage;
-}
-/**
-* Extract baggage from a W3C baggage header string.
-*/
-function extractBaggage(baggage) {
-	const carrier = { baggage };
-	return propagation.extract(context.active(), carrier);
-}
-/**
-* Extract both trace context and baggage from their respective headers.
-*/
-function extractContext(traceparent, baggage) {
-	const carrier = {};
-	if (traceparent) carrier.traceparent = traceparent;
-	if (baggage) carrier.baggage = baggage;
-	return propagation.extract(context.active(), carrier);
-}
-/**
-* Get a baggage entry from the current context.
-*/
-function getBaggageEntry(key) {
-	return propagation.getBaggage(context.active())?.getEntry(key)?.value;
-}
-/**
-* Set a baggage entry in the current context.
-*/
-function setBaggageEntry(key, value) {
-	let bag = propagation.getBaggage(context.active()) ?? propagation.createBaggage();
-	bag = bag.setEntry(key, { value });
-	return propagation.setBaggage(context.active(), bag);
-}
-/**
-* Remove a baggage entry from the current context.
-*/
-function removeBaggageEntry(key) {
-	const bag = propagation.getBaggage(context.active());
-	if (!bag) return context.active();
-	const newBag = bag.removeEntry(key);
-	return propagation.setBaggage(context.active(), newBag);
-}
-/**
-* Get all baggage entries from the current context.
-*/
-function getAllBaggage() {
-	const bag = propagation.getBaggage(context.active());
-	if (!bag) return {};
-	const entries = {};
-	for (const [key, entry] of bag.getAllEntries()) entries[key] = entry.value;
-	return entries;
-}
-
-//#endregion
-//#region src/telemetry-system/fetch-instrumentation.ts
-/**
-* Global fetch auto-instrumentation for the III Node SDK.
-*
-* Patches globalThis.fetch to create OTel CLIENT spans for every HTTP request.
-* Works on all runtimes (Bun, Node.js, Deno) unlike UndiciInstrumentation
-* which only works when fetch is backed by Node.js's undici.
-*/
-const textEncoder = new TextEncoder();
-function getBodyByteSize(body) {
-	if (body == null) return void 0;
-	if (typeof body === "string") return textEncoder.encode(body).byteLength;
-	if (body instanceof ArrayBuffer) return body.byteLength;
-	if (ArrayBuffer.isView(body)) return body.byteLength;
-	if (body instanceof Blob) return body.size;
-	if (body instanceof URLSearchParams) return new TextEncoder().encode(body.toString()).byteLength;
-}
-const SAFE_REQUEST_HEADERS$1 = ["content-type", "accept"];
-const SAFE_RESPONSE_HEADERS$1 = ["content-type"];
-let originalFetch = null;
-/**
-* Patch globalThis.fetch to create OTel CLIENT spans for every HTTP request.
-*/
-function patchGlobalFetch(tracer) {
-	if (originalFetch) return;
-	originalFetch = globalThis.fetch;
-	const capturedFetch = originalFetch;
-	globalThis.fetch = async (input, init) => {
-		const url = input instanceof Request ? input.url : String(input);
-		const method = (init?.method ?? (input instanceof Request ? input.method : "GET")).toUpperCase();
-		let host;
-		let scheme;
-		let path;
-		let port;
-		let query;
-		try {
-			const parsed = new URL(url);
-			host = parsed.hostname;
-			scheme = parsed.protocol.replace(":", "");
-			path = parsed.pathname;
-			port = parsed.port ? parseInt(parsed.port, 10) : void 0;
-			query = parsed.search ? parsed.search.slice(1) : void 0;
-		} catch {}
-		const spanAttributes = {
-			"http.request.method": method,
-			"url.full": url
-		};
-		if (host) spanAttributes["server.address"] = host;
-		if (scheme) {
-			spanAttributes["url.scheme"] = scheme;
-			spanAttributes["network.protocol.name"] = "http";
-		}
-		if (path) spanAttributes["url.path"] = path;
-		if (port) spanAttributes["server.port"] = port;
-		if (query) spanAttributes["url.query"] = query;
-		const spanName = path ? `${method} ${path}` : method;
-		return tracer.startActiveSpan(spanName, {
-			kind: SpanKind$1.CLIENT,
-			attributes: spanAttributes
-		}, context.active(), async (span) => {
-			try {
-				const carrier = {};
-				propagation.inject(context.active(), carrier);
-				const headers = new Headers(init?.headers ?? (input instanceof Request ? input.headers : void 0));
-				for (const [key, value] of Object.entries(carrier)) headers.set(key, value);
-				for (const name of SAFE_REQUEST_HEADERS$1) {
-					const value = headers.get(name);
-					if (value !== null) span.setAttribute(`http.request.header.${name}`, value);
-				}
-				const requestBodySize = getBodyByteSize(init?.body ?? (input instanceof Request ? input.body : void 0));
-				if (requestBodySize !== void 0) span.setAttribute("http.request.body.size", requestBodySize);
-				const response = await capturedFetch(input, {
-					...init,
-					headers
-				});
-				span.setAttribute("http.response.status_code", response.status);
-				const contentLength = response.headers.get("content-length");
-				if (contentLength !== null) {
-					const size = parseInt(contentLength, 10);
-					if (!Number.isNaN(size)) span.setAttribute("http.response.body.size", size);
-				}
-				for (const name of SAFE_RESPONSE_HEADERS$1) {
-					const value = response.headers.get(name);
-					if (value !== null) span.setAttribute(`http.response.header.${name}`, value);
-				}
-				if (response.status >= 400) {
-					span.setAttribute("error.type", String(response.status));
-					span.setStatus({ code: SpanStatusCode.ERROR });
-				} else span.setStatus({ code: SpanStatusCode.OK });
-				return response;
-			} catch (error) {
-				span.setAttribute("error.type", error.name ?? "Error");
-				span.setStatus({
-					code: SpanStatusCode.ERROR,
-					message: error.message
-				});
-				span.recordException(error);
-				throw error;
-			} finally {
-				span.end();
-			}
-		});
-	};
-}
-/**
-* Restore globalThis.fetch to its original implementation.
-*/
-function unpatchGlobalFetch() {
-	if (originalFetch) {
-		globalThis.fetch = originalFetch;
-		originalFetch = null;
-	}
-}
-
-//#endregion
-//#region src/telemetry-system/utils.ts
-/**
-* Parse a numeric environment variable with optional minimum bound.
-*/
-function parseNumberEnv(value, minimum = 0) {
-	if (value === void 0) return void 0;
-	const parsed = Number(value);
-	if (!Number.isFinite(parsed) || parsed < minimum) return void 0;
-	return parsed;
-}
-/**
-* Parse an integer environment variable with optional minimum bound.
-*/
-function parseIntegerEnv(value, minimum = 0) {
-	const parsed = parseNumberEnv(value, minimum);
-	if (parsed === void 0 || !Number.isInteger(parsed)) return void 0;
-	return parsed;
-}
-
-//#endregion
-//#region src/telemetry-system/span-ops.ts
-/** High-level span operations so consumers don't need `@opentelemetry/api`. */
-/** Returns `false` when there is no active span or the sampler dropped it. */
-function currentSpanIsRecording() {
-	const span = trace.getActiveSpan();
-	return span ? span.isRecording() : false;
-}
-/** No-op when the current span is not recording. */
-function setCurrentSpanAttribute(key, value) {
-	const span = trace.getActiveSpan();
-	if (!span || !span.isRecording()) return;
-	span.setAttribute(key, value);
-}
-/** No-op when there is no active span. */
-function setCurrentSpanError(message) {
-	const span = trace.getActiveSpan();
-	if (!span) return;
-	span.setStatus({
-		code: SpanStatusCode.ERROR,
-		message
-	});
-}
-/** No-op when the current span is not recording. */
-function recordSpanEvent(name, attrs) {
-	const span = trace.getActiveSpan();
-	if (!span || !span.isRecording()) return;
-	span.addEvent(name, attrs);
-}
-
-//#endregion
-//#region src/telemetry-system/payload.ts
-/** Payload redaction + truncation for invocation event capture. */
-const REDACTED_PLACEHOLDER = "[REDACTED]";
-const TRUNCATION_MARKER = "...\"[TRUNCATED]\"";
-function resolveMaxBytesFromEnv() {
-	const raw = process.env.III_TRACE_PAYLOAD_MAX_BYTES;
-	if (raw === void 0) return null;
-	const trimmed = raw.trim();
-	if (trimmed === "" || trimmed.toLowerCase() === "unlimited") return null;
-	if (!/^\d+$/.test(trimmed)) return null;
-	const parsed = Number(trimmed);
-	if (parsed <= 0) return null;
-	return parsed;
-}
-const SENSITIVE_FRAGMENTS = [
-	"api_key",
-	"apikey",
-	"api-key",
-	"password",
-	"secret",
-	"credential",
-	"authorization",
-	"auth_token",
-	"access_token",
-	"refresh_token",
-	"bearer",
-	"private_key",
-	"client_secret"
-];
-function isSensitiveKey(key) {
-	const lower = key.toLowerCase();
-	if (SENSITIVE_FRAGMENTS.some((fragment) => lower.includes(fragment))) return true;
-	return lower === "token" || lower.endsWith("_token") || lower.endsWith("-token");
-}
-/** Recursively redact values of sensitive keys. Returns a new value. */
-function redact(value) {
-	if (value === null || value === void 0) return value;
-	if (Array.isArray(value)) return value.map(redact);
-	if (typeof value === "object") {
-		const out = {};
-		for (const [k, v] of Object.entries(value)) out[k] = isSensitiveKey(k) ? REDACTED_PLACEHOLDER : redact(v);
-		return out;
-	}
-	return value;
-}
-/** Redact then serialize to JSON, optionally capped at `maxBytes`. */
-function redactAndTruncate(value, maxBytes = null) {
-	const redacted = redact(value);
-	let serialized;
-	try {
-		serialized = JSON.stringify(redacted) ?? "null";
-	} catch {
-		serialized = "null";
-	}
-	if (maxBytes === null || maxBytes === void 0 || maxBytes <= 0) return {
-		json: serialized,
-		truncated: false
-	};
-	if (Buffer.byteLength(serialized, "utf8") <= maxBytes) return {
-		json: serialized,
-		truncated: false
-	};
-	const markerLen = Buffer.byteLength(TRUNCATION_MARKER, "utf8");
-	if (maxBytes <= markerLen) return {
-		json: TRUNCATION_MARKER.slice(0, maxBytes),
-		truncated: true
-	};
-	const cap = maxBytes - markerLen;
-	const buf = Buffer.from(serialized, "utf8");
-	let cut = Math.min(cap, buf.length);
-	while (cut > 0 && (buf[cut] & 192) === 128) cut -= 1;
-	return {
-		json: buf.subarray(0, cut).toString("utf8") + TRUNCATION_MARKER,
-		truncated: true
-	};
-}
-
-//#endregion
-//#region src/telemetry-system/index.ts
-/**
-* OpenTelemetry initialization for the III Node SDK.
-*
-* This module provides trace, metrics, and log export to the III Engine
-* via a shared WebSocket connection using OTLP JSON format.
-*/
-/**
-* Normalize an engine WebSocket URL into the dedicated OTEL endpoint.
-* The engine exposes `/otel` for telemetry-only WS connections; routing
-* there keeps this socket out of the worker registry (otherwise it shows
-* up as a ghost null-metadata worker).
-*/
-function appendOtelPath(base) {
-	const url = new URL(base);
-	const path = url.pathname.replace(/\/+$/, "");
-	url.pathname = path.endsWith("/otel") ? path : `${path}/otel`;
-	return url.toString();
-}
-let sharedConnection = null;
-let tracerProvider = null;
-let meterProvider = null;
-let loggerProvider = null;
-let tracer = null;
-let meter = null;
-let logger = null;
-let serviceName = "iii-node-iii";
-/**
-* Initialize OpenTelemetry with the given configuration.
-* This should be called once at application startup.
-*/
-function initOtel(config = {}) {
-	if (!(config.enabled ?? parseBoolEnv(process.env.OTEL_ENABLED, DEFAULT_OTEL_CONFIG.enabled))) {
-		console.debug("[OTel] OpenTelemetry is disabled. To enable, remove OTEL_ENABLED=false or set enabled: true in config.");
-		return;
-	}
-	serviceName = config.serviceName ?? process.env.OTEL_SERVICE_NAME ?? DEFAULT_OTEL_CONFIG.serviceName;
-	const serviceVersion = config.serviceVersion ?? process.env.SERVICE_VERSION ?? DEFAULT_OTEL_CONFIG.serviceVersion;
-	const serviceNamespace = config.serviceNamespace ?? process.env.SERVICE_NAMESPACE;
-	const serviceInstanceId = config.serviceInstanceId ?? process.env.SERVICE_INSTANCE_ID ?? randomUUID();
-	const engineWsUrl = config.engineWsUrl ?? process.env.III_URL ?? DEFAULT_OTEL_CONFIG.engineWsUrl;
-	const resourceAttributes = {
-		[ATTR_SERVICE_NAME]: serviceName,
-		[ATTR_SERVICE_VERSION]: serviceVersion,
-		[ATTR_SERVICE_INSTANCE_ID]: serviceInstanceId
-	};
-	if (serviceNamespace) resourceAttributes[ATTR_SERVICE_NAMESPACE] = serviceNamespace;
-	const resource = new Resource(resourceAttributes);
-	sharedConnection = new SharedEngineConnection(appendOtelPath(engineWsUrl), config.reconnectionConfig);
-	const spanExporter = new EngineSpanExporter(sharedConnection);
-	tracerProvider = new NodeTracerProvider({
-		resource,
-		spanProcessors: [new BaggageSpanProcessor(), new BatchSpanProcessor(spanExporter)]
-	});
-	propagation.setGlobalPropagator(new CompositePropagator({ propagators: [new W3CTraceContextPropagator(), new W3CBaggagePropagator()] }));
-	tracerProvider.register();
-	tracer = trace.getTracer(serviceName);
-	console.debug(`[OTel] Traces initialized: engine=${engineWsUrl}, service=${serviceName}`);
-	if (config.metricsEnabled ?? parseBoolEnv(process.env.OTEL_METRICS_ENABLED, DEFAULT_OTEL_CONFIG.metricsEnabled)) {
-		const metricsExporter = new EngineMetricsExporter(sharedConnection);
-		const exportIntervalMs = config.metricsExportIntervalMs ?? DEFAULT_OTEL_CONFIG.metricsExportIntervalMs;
-		meterProvider = new MeterProvider({
-			resource,
-			readers: [new PeriodicExportingMetricReader({
-				exporter: metricsExporter,
-				exportIntervalMillis: exportIntervalMs
-			})]
-		});
-		metrics.setGlobalMeterProvider(meterProvider);
-		meter = meterProvider.getMeter(serviceName);
-		console.debug(`[OTel] Metrics initialized: interval=${exportIntervalMs}ms`);
-	}
-	const instrumentations = [...config.instrumentations ?? []];
-	if (instrumentations.length > 0) {
-		registerInstrumentations({
-			instrumentations,
-			tracerProvider,
-			meterProvider: meterProvider ?? void 0
-		});
-		console.debug(`[OTel] Instrumentations registered: ${instrumentations.length} total`);
-	}
-	if (config.fetchInstrumentationEnabled ?? DEFAULT_OTEL_CONFIG.fetchInstrumentationEnabled) {
-		patchGlobalFetch(tracer);
-		console.debug("[OTel] Global fetch instrumentation enabled");
-	}
-	const logExporter = new EngineLogExporter(sharedConnection);
-	const logsScheduledDelayMillis = config.logsFlushIntervalMs ?? parseNumberEnv(process.env.OTEL_LOGS_FLUSH_INTERVAL_MS, 0) ?? DEFAULT_OTEL_CONFIG.logsFlushIntervalMs;
-	const logsMaxExportBatchSize = config.logsBatchSize ?? parseIntegerEnv(process.env.OTEL_LOGS_BATCH_SIZE, 1) ?? DEFAULT_OTEL_CONFIG.logsBatchSize;
-	loggerProvider = new LoggerProvider({ resource });
-	loggerProvider.addLogRecordProcessor(new BatchLogRecordProcessor(logExporter, {
-		scheduledDelayMillis: logsScheduledDelayMillis,
-		maxExportBatchSize: logsMaxExportBatchSize
-	}));
-	logger = loggerProvider.getLogger(serviceName);
-	console.debug(`[OTel] Logs initialized: delay=${logsScheduledDelayMillis}ms, batch=${logsMaxExportBatchSize}`);
-}
-/**
-* Shutdown OpenTelemetry, flushing any pending data.
-*/
-async function shutdownOtel() {
-	if (tracerProvider) {
-		await tracerProvider.forceFlush();
-		await tracerProvider.shutdown();
-		tracerProvider = null;
-	}
-	if (meterProvider) {
-		await meterProvider.forceFlush();
-		await meterProvider.shutdown();
-		meterProvider = null;
-	}
-	if (loggerProvider) {
-		await loggerProvider.forceFlush();
-		await loggerProvider.shutdown();
-		loggerProvider = null;
-	}
-	if (sharedConnection) {
-		await sharedConnection.shutdown();
-		sharedConnection = null;
-	}
-	unpatchGlobalFetch();
-	tracer = null;
-	meter = null;
-	logger = null;
-}
-/**
-* Force-flush all OTel providers without tearing them down.
-*
-* Counterpart to {@link shutdownOtel}. Use before short-lived process exits
-* where you want pending spans/metrics/logs delivered but plan to keep using
-* OTel afterwards.
-*/
-async function flushOtel() {
-	await Promise.all([
-		tracerProvider?.forceFlush(),
-		meterProvider?.forceFlush(),
-		loggerProvider?.forceFlush()
-	].filter(Boolean));
-}
-/**
-* Get the OpenTelemetry tracer instance.
-*/
-function getTracer() {
-	return tracer;
-}
-/**
-* Get the OpenTelemetry meter instance.
-*/
-function getMeter() {
-	return meter;
-}
-/**
-* Get the OpenTelemetry logger instance.
-*/
-function getLogger() {
-	return logger;
-}
-/**
-* Start a new span with the given name and run the callback within it.
-*/
-async function withSpan(name, options, fn) {
-	if (!tracer) {
-		const noopSpan = {
-			spanContext: () => ({
-				traceId: "",
-				spanId: "",
-				traceFlags: 0
-			}),
-			setAttribute: () => noopSpan,
-			setAttributes: () => noopSpan,
-			addEvent: () => noopSpan,
-			addLink: () => noopSpan,
-			setStatus: () => noopSpan,
-			updateName: () => noopSpan,
-			end: () => {},
-			isRecording: () => false,
-			recordException: () => {},
-			addLinks: () => noopSpan
-		};
-		return fn(noopSpan);
-	}
-	const parentContext = options.traceparent ? extractTraceparent(options.traceparent) : context.active();
-	return tracer.startActiveSpan(name, { kind: options.kind ?? SpanKind.INTERNAL }, parentContext, async (span) => {
-		try {
-			const result = await fn(span);
-			span.setStatus({ code: SpanStatusCode$1.OK });
-			return result;
-		} catch (error) {
-			span.setStatus({
-				code: SpanStatusCode$1.ERROR,
-				message: error.message
-			});
-			span.recordException(error);
-			throw error;
-		} finally {
-			span.end();
-		}
-	});
-}
-
-//#endregion
 //#region src/logger.ts
 /**
 * Structured logger that emits logs as OpenTelemetry LogRecords.
@@ -1213,7 +159,7 @@ async function executeTracedRequest(input, init) {
 	const method = (init?.method ?? (typeof input === "object" && "method" in input ? input.method : "GET") ?? "GET").toUpperCase();
 	const name = url?.pathname ? `${method} ${url.pathname}` : method;
 	return tracer.startActiveSpan(name, {
-		kind: SpanKind$1.CLIENT,
+		kind: SpanKind.CLIENT,
 		attributes: {
 			"http.request.method": method,
 			"url.full": url?.toString() ?? rawUrl,
@@ -1505,5 +451,5 @@ function safeStringify(value) {
 }
 
 //#endregion
-export { BaggageSpanProcessor, DEFAULT_ALLOWLIST, Logger, REDACTED_PLACEHOLDER, SeverityNumber, SpanKind, WorkerMetricsCollector, currentSpanId, currentSpanIsRecording, currentTraceId, executeTracedRequest, extractBaggage, extractContext, extractTraceparent, flushOtel, getAllBaggage, getBaggageEntry, getLogger, getMeter, getTracer, initOtel, injectBaggage, injectTraceparent, patchGlobalFetch, recordSpanEvent, redact, redactAndTruncate, registerWorkerGauges, removeBaggageEntry, resolveMaxBytesFromEnv, safeStringify, setBaggageEntry, setCurrentSpanAttribute, setCurrentSpanError, shutdownOtel, stopWorkerGauges, unpatchGlobalFetch, withSpan };
+export { BaggageSpanProcessor, DEFAULT_ALLOWLIST, Logger, REDACTED_PLACEHOLDER, SeverityNumber, WorkerMetricsCollector, currentSpanId, currentSpanIsRecording, currentTraceId, executeTracedRequest, extractBaggage, extractContext, extractTraceparent, flushOtel, getAllBaggage, getBaggageEntry, getLogger, initOtel, injectBaggage, injectTraceparent, patchGlobalFetch, recordSpanEvent, redact, redactAndTruncate, registerWorkerGauges, removeBaggageEntry, resolveMaxBytesFromEnv, safeStringify, setBaggageEntry, setCurrentSpanAttribute, setCurrentSpanError, shutdownOtel, stopWorkerGauges, unpatchGlobalFetch, withSpan };
 //# sourceMappingURL=index.mjs.map