@capxul/observability 4.2.0 → 4.20.0-beta.10

package/dist/engineering.mjs

@@ -1,7 +1,382 @@
-import { i as redactUrlSecrets, n as isCredentialField, r as redactSecrets } from "./src-CWfRYsBI.mjs";
-import { Cause, Effect, Exit, FiberSet, Layer, Stream, Tracer } from "effect";
-import { FetchHttpClient, Headers, HttpClient } from "effect/unstable/http";
-import { OtlpExporter, OtlpLogger, OtlpSerialization, OtlpTracer } from "effect/unstable/observability";
+import { _ as CLI_COMMAND_NAMES, cn as CAPXUL_ERROR_CODES, dn as redactSecrets, fn as redactUrlSecrets, g as CLI_CAPABILITIES, ln as FAILURE_MODES, on as isCapxulOperation, un as isCredentialField, v as CLI_INVOCATION_KINDS } from "./src-Dhf8f_EV.mjs";
+import { Cause, Clock, Context, Deferred, Duration, Effect, Exit, FiberSet, Layer, LogLevel, Logger, Metric, Option, References, Schedule, Stream, Tracer } from "effect";
+import { FetchHttpClient, Headers, HttpBody, HttpClient, HttpClientError, HttpClientResponse } from "effect/unstable/http";
+import { OtlpExporter, OtlpLogger, OtlpMetrics, OtlpSerialization, OtlpTracer } from "effect/unstable/observability";
+//#region src/engineering-delivery.ts
+/** Fixed admission limits for one CLI invocation and its SDK client. */
+const CLI_ENGINEERING_LIMITS = Object.freeze({
+	records: 80,
+	ordinaryRecords: 64,
+	recordBytes: 16384,
+	requests: 5,
+	ordinaryRequests: 2,
+	requestBytes: 1572864,
+	metricSeries: 16,
+	requestTimeoutMs: 1e3
+});
+const metricNames = /* @__PURE__ */ new Set(["capxul.cli.command.count", "capxul.cli.command.duration"]);
+const metricValues = {
+	command: CLI_COMMAND_NAMES,
+	capability: CLI_CAPABILITIES,
+	invocation_kind: CLI_INVOCATION_KINDS,
+	outcome: [
+		"succeeded",
+		"refused",
+		"failed",
+		"cancelled"
+	],
+	capxul_env: [
+		"development",
+		"staging",
+		"production",
+		"local"
+	],
+	unit: [
+		"1",
+		"s",
+		"ms"
+	]
+};
+/** Only this bounded registry is supplied to the CLI's metric producers. */
+var CliMetricRegistry = class extends Map {
+	dropped;
+	enabled;
+	constructor(dropped, enabled = true) {
+		super();
+		this.dropped = dropped;
+		this.enabled = enabled;
+	}
+	set(key, entry) {
+		if (!this.enabled || !metricNames.has(entry.id) || !this.has(key) && this.size >= CLI_ENGINEERING_LIMITS.metricSeries) {
+			this.dropped();
+			return this;
+		}
+		const labels = Object.entries(entry.attributes ?? {});
+		const state = entry.hooks.get(Context.empty());
+		const buckets = typeof state === "object" && state !== null && "buckets" in state ? state.buckets : void 0;
+		if (!["Counter", "Histogram"].includes(entry.type) || (entry.description?.length ?? 0) > 128 || labels.length > 6 || labels.some(([name, value]) => !metricValues[name]?.includes(String(value))) || entry.type === "Histogram" && (!Array.isArray(buckets) || buckets.length > 32)) {
+			this.dropped();
+			return this;
+		}
+		return super.set(key, entry);
+	}
+};
+/** Shared, closure-owned admission state; no queue or mutable counters are exposed. */
+function makeCliEngineeringBudget() {
+	let records = 0, peakRecords = 0, activeRequests = 0, requestBytes = 0;
+	let peakRequests = 0, peakRequestBytes = 0, dropped = 0;
+	const drop = () => {
+		dropped += 1;
+	};
+	const metricRegistry = new CliMetricRegistry(drop);
+	return Object.freeze({
+		metricRegistry,
+		emptyMetricRegistry: () => new CliMetricRegistry(drop, false),
+		drop,
+		admitRecord(terminal) {
+			if (records >= (terminal ? CLI_ENGINEERING_LIMITS.records : CLI_ENGINEERING_LIMITS.ordinaryRecords)) {
+				drop();
+				return;
+			}
+			records += 1;
+			peakRecords = Math.max(peakRecords, records);
+			let released = false;
+			return () => {
+				if (!released) {
+					released = true;
+					records -= 1;
+				}
+			};
+		},
+		admitRequest(bytes, terminal) {
+			if (bytes > CLI_ENGINEERING_LIMITS.requestBytes || activeRequests >= (terminal ? CLI_ENGINEERING_LIMITS.requests : CLI_ENGINEERING_LIMITS.ordinaryRequests)) {
+				drop();
+				return;
+			}
+			activeRequests += 1;
+			requestBytes += bytes;
+			peakRequests = Math.max(peakRequests, activeRequests);
+			peakRequestBytes = Math.max(peakRequestBytes, requestBytes);
+			return () => {
+				activeRequests -= 1;
+				requestBytes -= bytes;
+			};
+		},
+		snapshot() {
+			return {
+				records,
+				reservedRecordBytes: records * CLI_ENGINEERING_LIMITS.recordBytes,
+				peakRecords,
+				peakReservedRecordBytes: peakRecords * CLI_ENGINEERING_LIMITS.recordBytes,
+				activeRequests,
+				requestBytes,
+				peakRequests,
+				peakRequestBytes,
+				dropped,
+				metricSeries: metricRegistry.size
+			};
+		}
+	});
+}
+const text = (value) => typeof value === "string" ? value.slice(0, 128) : "capxul.engineering";
+const attributes = (input, limit = 32) => {
+	const out = {};
+	let count = 0;
+	let bytes = 0;
+	try {
+		for (const key in input) {
+			if (count++ >= limit) break;
+			if (key.length > 64) continue;
+			const value = Object.getOwnPropertyDescriptor(input, key)?.value;
+			const scalar = typeof value === "string" ? value.slice(0, 128) : typeof value === "boolean" || typeof value === "number" && Number.isFinite(value) ? value : void 0;
+			if (scalar === void 0) continue;
+			bytes += new TextEncoder().encode(JSON.stringify([key, scalar])).length;
+			if (bytes > (limit >= 24 ? 2e3 : 300)) break;
+			out[key] = scalar;
+		}
+	} catch {}
+	return out;
+};
+const terminalName = (name) => name === "cli.command.completed" || name === "cli.wallet.step" || CLI_COMMAND_NAMES.some((command) => name === `cli.command.${command}`);
+/** Native exporters retain their serialization and scheduling; this owns admission only. */
+function cliEngineeringDelivery(budget, ownsMetrics) {
+	const closed = Deferred.makeUnsafe();
+	let isClosed = false;
+	let metricsRunning = false;
+	const logs = [];
+	const spans = /* @__PURE__ */ new Map();
+	const terminalBodies = /* @__PURE__ */ new WeakSet();
+	const bodyLeases = /* @__PURE__ */ new WeakMap();
+	const pendingBodies = /* @__PURE__ */ new Set();
+	const holdBody = (body, releases) => {
+		if (releases.length === 0) return;
+		const lease = {
+			started: false,
+			release: () => {
+				if (!pendingBodies.delete(lease)) return;
+				bodyLeases.delete(body);
+				for (const release of releases) release();
+			}
+		};
+		bodyLeases.set(body, lease);
+		pendingBodies.add(lease);
+	};
+	const discardBody = (body) => bodyLeases.get(body)?.release();
+	const drainLogs = () => {
+		for (const release of logs.splice(0)) release();
+	};
+	const close = () => {
+		isClosed = true;
+		Deferred.doneUnsafe(closed, Effect.void);
+		for (const lease of pendingBodies) if (!lease.started) lease.release();
+		drainLogs();
+		for (const release of spans.values()) release();
+		spans.clear();
+		if (ownsMetrics) budget.metricRegistry.clear();
+	};
+	return {
+		close,
+		discardBody,
+		metrics(run) {
+			return Effect.suspend(() => {
+				if (isClosed || metricsRunning) return Effect.void;
+				metricsRunning = true;
+				return run.pipe(Effect.ensuring(Effect.sync(() => {
+					metricsRunning = false;
+				})));
+			});
+		},
+		logger(delegate) {
+			return Logger.make((options) => {
+				if (isClosed) return;
+				let release;
+				try {
+					const message = text(Array.isArray(options.message) ? Object.getOwnPropertyDescriptor(options.message, "0")?.value : options.message);
+					release = budget.admitRecord(terminalName(message));
+					if (release === void 0) return;
+					const context = Context.add(options.fiber.context, References.CurrentLogAnnotations, attributes(options.fiber.getRef(References.CurrentLogAnnotations)));
+					const fiber = Object.create(options.fiber);
+					Object.defineProperty(fiber, "getRef", { value: (ref) => Context.get(context, ref) });
+					logs.push(release);
+					delegate.log({
+						...options,
+						message,
+						cause: Cause.empty,
+						fiber
+					});
+				} catch {
+					if (release !== void 0) {
+						const index = logs.indexOf(release);
+						if (index !== -1) logs.splice(index, 1);
+						release();
+					}
+					budget.drop();
+				}
+			});
+		},
+		tracer(delegate) {
+			return Tracer.make({
+				span(options) {
+					const name = text(options.name);
+					const release = isClosed ? void 0 : budget.admitRecord(terminalName(name));
+					const spanOptions = {
+						...options,
+						name,
+						annotations: Context.empty(),
+						links: []
+					};
+					const span = release === void 0 ? new Tracer.NativeSpan({
+						...spanOptions,
+						sampled: false
+					}) : delegate.span(spanOptions);
+					if (release !== void 0) spans.set(span.spanId, release);
+					const wrapped = Object.create(span);
+					let fields = 0, events = 0, links = 0, attributeBytes = 0;
+					let ended = false;
+					Object.defineProperties(wrapped, {
+						attribute: { value: (key, value) => {
+							if (fields >= 32 && !span.attributes.has(key)) {
+								budget.drop();
+								return;
+							}
+							const safe = attributes({ [key]: value }, 1);
+							if (!Object.hasOwn(safe, key)) return;
+							const previous = span.attributes.has(key) ? new TextEncoder().encode(JSON.stringify([key, span.attributes.get(key)])).length : 0;
+							const next = new TextEncoder().encode(JSON.stringify([key, safe[key]])).length;
+							if (attributeBytes - previous + next > 2e3) {
+								budget.drop();
+								return;
+							}
+							attributeBytes += next - previous;
+							if (!span.attributes.has(key)) fields += 1;
+							span.attribute(key, safe[key]);
+						} },
+						event: { value: (eventName, time, attrs) => {
+							if (events++ >= 2) {
+								budget.drop();
+								return;
+							}
+							span.event(text(eventName), time, attributes(attrs ?? {}, 4));
+						} },
+						addLinks: { value: (items) => {
+							for (const item of items.slice(0, Math.max(0, 2 - links))) {
+								if (!/^[a-f0-9]{32}$/u.test(item.span.traceId) || !/^[a-f0-9]{16}$/u.test(item.span.spanId)) {
+									budget.drop();
+									continue;
+								}
+								span.addLinks([{
+									span: Tracer.externalSpan({
+										traceId: item.span.traceId,
+										spanId: item.span.spanId,
+										sampled: item.span.sampled
+									}),
+									attributes: attributes(item.attributes, 4)
+								}]);
+								links += 1;
+							}
+						} },
+						end: { value: (time, exit) => {
+							if (ended) return;
+							ended = true;
+							span.end(time, Exit.isFailure(exit) ? Exit.fail("CLI operation failed") : Exit.void);
+						} }
+					});
+					wrapped.addLinks(options.links ?? []);
+					return wrapped;
+				},
+				...delegate.context === void 0 ? {} : { context: delegate.context.bind(delegate) }
+			});
+		},
+		serialization(delegate) {
+			return {
+				logs(data) {
+					const releases = logs.splice(0);
+					try {
+						const body = delegate.logs(data);
+						if (data.resourceLogs.some((r) => r.scopeLogs.some((s) => s.logRecords?.some((l) => terminalName(l.body?.stringValue ?? ""))))) terminalBodies.add(body);
+						holdBody(body, releases);
+						return body;
+					} catch (error) {
+						for (const release of releases) release();
+						throw error;
+					}
+				},
+				traces(data) {
+					const releases = [];
+					for (const resource of data.resourceSpans) for (const scope of resource.scopeSpans) for (const span of scope.spans) {
+						const release = spans.get(span.spanId);
+						if (release !== void 0) releases.push(release);
+						spans.delete(span.spanId);
+					}
+					try {
+						const body = delegate.traces(data);
+						if (data.resourceSpans.some((r) => r.scopeSpans.some((s) => s.spans.some((span) => terminalName(span.name))))) terminalBodies.add(body);
+						holdBody(body, releases);
+						return body;
+					} catch (error) {
+						for (const release of releases) release();
+						throw error;
+					}
+				},
+				metrics(data) {
+					const body = delegate.metrics(data);
+					terminalBodies.add(body);
+					return body;
+				}
+			};
+		},
+		transport(client, enabled = () => true) {
+			const retrying = HttpClient.transform(client, (response, request) => Effect.suspend(() => {
+				if (enabled()) return response;
+				budget.drop();
+				return Effect.succeed(HttpClientResponse.fromWeb(request, new Response(null)));
+			})).pipe(HttpClient.transformResponse((response) => Effect.tap(response, (result) => {
+				let received = 0;
+				return Stream.runForEach(result.stream, (chunk) => Effect.sync(() => {
+					received += chunk.byteLength;
+					if (received > 65536) throw new Error("Engineering response limit exceeded");
+				})).pipe(Effect.catchTag("HttpClientError", (error) => error.reason._tag === "EmptyBodyError" ? Effect.void : Effect.fail(error)));
+			}))).pipe(HttpClient.filterStatusOk, HttpClient.retryTransient({
+				times: 1,
+				schedule: Schedule.spaced("100 millis").pipe(Schedule.addDelay(({ input }) => Effect.map(Clock.currentTimeMillis, (now) => {
+					if (!HttpClientError.isHttpClientError(input) || input.reason._tag !== "StatusCodeError" || input.reason.response.status !== 429) return Duration.zero;
+					const header = input.reason.response.headers["retry-after"];
+					const numeric = Number(header);
+					const delay = header === void 0 ? 2e3 : Number.isFinite(numeric) ? numeric * 1e3 : Date.parse(header) - now;
+					return Duration.millis(Number.isFinite(delay) ? Math.min(2e3, Math.max(0, delay)) : 2e3);
+				})))
+			}));
+			return HttpClient.transform(retrying, (response, request) => Effect.suspend(() => {
+				if (isClosed) {
+					discardBody(request.body);
+					return Effect.succeed(HttpClientResponse.fromWeb(request, new Response(null)));
+				}
+				const droppedResponse = () => HttpClientResponse.fromWeb(request, new Response(null, { status: 200 }));
+				if (request.body._tag === "Empty") {
+					discardBody(request.body);
+					return Effect.succeed(droppedResponse());
+				}
+				const bytes = request.body.contentLength;
+				const release = budget.admitRequest(bytes ?? Number.POSITIVE_INFINITY, terminalBodies.has(request.body));
+				if (release === void 0) {
+					discardBody(request.body);
+					return Effect.succeed(droppedResponse());
+				}
+				const lease = bodyLeases.get(request.body);
+				if (lease !== void 0) lease.started = true;
+				return response.pipe(Effect.asVoid, Effect.timeoutOption(CLI_ENGINEERING_LIMITS.requestTimeoutMs), Effect.raceFirst(Deferred.await(closed).pipe(Effect.andThen(Effect.interrupt))), Effect.tap((result) => Effect.sync(() => {
+					if (Option.isNone(result)) budget.drop();
+				})), Effect.catchCause(() => Effect.sync(() => {
+					budget.drop();
+				})), Effect.as(droppedResponse()), Effect.ensuring(Effect.sync(() => {
+					release();
+					discardBody(request.body);
+				})));
+			}));
+		}
+	};
+}
+//#endregion
 //#region src/engineering.ts
 const ENGINEERING_CAPXUL_ENVS = [
 	"development",
@@ -15,13 +390,18 @@ const postHogOtlpEndpoints = (host) => {
 	const base = host.replace(/\/+$/, "");
 	return {
 		logs: `${base}/i/v1/logs`,
-		traces: `${base}/i/v1/traces`
+		traces: `${base}/i/v1/traces`,
+		metrics: `${base}/i/v1/metrics`
 	};
 };
 const ENGINEERING_CAPXUL_ENV_SET = new Set(ENGINEERING_CAPXUL_ENVS);
 const ENGINEERING_PRODUCERS = /* @__PURE__ */ new Set(["browser", "server"]);
 const PUBLIC_POSTHOG_AUTHORIZATION = /^Bearer phc_[A-Za-z0-9_-]{1,191}$/u;
 const SAFE_RESOURCE_VALUE = /^[A-Za-z0-9][A-Za-z0-9._+@/-]{0,127}$/u;
+function validateEngineeringPrivacy(config) {
+	if (config.privacy !== void 0 && config.privacy !== "minimal") throw new TypeError("engineering telemetry privacy must be minimal when specified");
+	if (config.privacy === "minimal" && (!/^[A-Za-z0-9][A-Za-z0-9._+@-]{0,127}$/u.test(config.sdkVersion) || config.serviceName !== void 0 && !/^[A-Za-z0-9][A-Za-z0-9._+@-]{0,127}$/u.test(config.serviceName))) throw new TypeError("minimal engineering resource values must not contain paths");
+}
 const validateEngineeringTelemetryConfig = (config) => {
 	let url;
 	try {
@@ -32,6 +412,8 @@ const validateEngineeringTelemetryConfig = (config) => {
 	if (url.protocol !== "https:" || url.username.length > 0 || url.password.length > 0 || url.pathname !== "/" || url.search.length > 0 || url.hash.length > 0 || !(url.hostname === "posthog.com" || url.hostname.endsWith(".posthog.com"))) throw new TypeError("engineering telemetry host must be a credential-free HTTPS origin");
 	if (!ENGINEERING_CAPXUL_ENV_SET.has(config.capxulEnv)) throw new TypeError("engineering telemetry capxulEnv is not canonical");
 	if (!ENGINEERING_PRODUCERS.has(config.producer)) throw new TypeError("engineering telemetry producer is not canonical");
+	if (config.enabled !== void 0 && typeof config.enabled !== "boolean" && typeof config.enabled !== "function") throw new TypeError("engineering telemetry enabled must be a boolean or callback");
+	validateEngineeringPrivacy(config);
 	if (!SAFE_RESOURCE_VALUE.test(config.sdkVersion)) throw new TypeError("engineering telemetry sdkVersion must be a bounded safe value");
 	if (config.serviceName !== void 0 && !SAFE_RESOURCE_VALUE.test(config.serviceName)) throw new TypeError("engineering telemetry serviceName must be a bounded safe value");
 	const headerEntries = Object.entries(config.headers);
@@ -82,25 +464,34 @@ const spanUpstream = (span) => {
 	let current = span;
 	while (current?._tag === "Span") {
 		const upstream = current.attributes.get("chain.upstream");
-		if (upstream === "alchemy" || upstream === "infura") return upstream;
+		if (upstream === "alchemy" || upstream === "infura" || upstream === "gateway") return upstream;
 		current = current.parent._tag === "Some" ? current.parent.value : void 0;
 	}
 };
+function redactHttpPath(path, fullUrl, source) {
+	let origin = "https://redaction.invalid";
+	try {
+		const url = new URL(String(fullUrl));
+		if (url.protocol === "https:" || url.protocol === "http:") origin = url.origin;
+	} catch {}
+	const prefix = path.startsWith("/") ? origin : "";
+	return redactUrlSecrets(`${prefix}${path}`, source).slice(prefix.length, prefix.length + 2048);
+}
 /** Preserve domain exits while preventing the OTLP serializer from seeing raw causes. */
-const makeLeakSafeEngineeringTracer = (delegate) => Tracer.make({
+const makeLeakSafeEngineeringTracer = (delegate, enabled = () => true) => Tracer.make({
 	span(options) {
-		const span = delegate.span(options);
+		const span = enabled() ? delegate.span(options) : new Tracer.NativeSpan(options);
 		const wrapped = Object.create(span);
 		Object.defineProperty(wrapped, "attribute", { value: (name, value) => {
 			const source = spanUpstream(span);
 			const header = /^http\.(?:request|response)\.header\.(.+)$/u.exec(name)?.[1];
 			if (header !== void 0 && isCredentialField(header, "header")) span.attribute(name, "[REDACTED]");
 			else if (typeof value === "string" && name === "url.query") span.attribute(name, redactUrlSecrets(`?${value}`).slice(1, 2049));
-			else if (typeof value === "string" && name === "url.path") {
-				const fullUrl = span.attributes.get("url.full");
-				const path = typeof fullUrl === "string" ? /^https?:\/\/[^/]+([^?#]*)/u.exec(fullUrl)?.[1] ?? value : value;
-				span.attribute(name, redactUrlSecrets(path, source).slice(0, 2048));
-			} else if (typeof value === "string" && (name === "url.full" || header === "location" || header === "referer" || header === "referrer")) span.attribute(name, redactUrlSecrets(value, source).slice(0, 2048));
+			else if (typeof value === "string" && (name === "url.path" || name === "http.target")) {
+				const fullUrl = span.attributes.get("url.full") ?? span.attributes.get("http.url");
+				const path = name === "url.path" && typeof fullUrl === "string" ? /^https?:\/\/[^/]+([^?#]*)/u.exec(fullUrl)?.[1] ?? value : value;
+				span.attribute(name, redactHttpPath(path, fullUrl, source));
+			} else if (typeof value === "string" && (name === "url.full" || name === "http.url" || header === "location" || header === "referer" || header === "referrer")) span.attribute(name, redactUrlSecrets(value, source).slice(0, 2048));
 			else if (header !== void 0 && typeof value === "string") span.attribute(name, redactSecrets(value, source).slice(0, 2048));
 			else span.attribute(name, value);
 		} });
@@ -108,6 +499,15 @@ const makeLeakSafeEngineeringTracer = (delegate) => Tracer.make({
 			configurable: false,
 			enumerable: false,
 			value: (endTime, exit) => {
+				if (!enabled()) {
+					Object.defineProperty(wrapped, "status", { value: {
+						_tag: "Ended",
+						startTime: span.status.startTime,
+						endTime,
+						exit
+					} });
+					return;
+				}
 				if (Exit.isFailure(exit) && !Cause.hasInterruptsOnly(exit.cause)) {
 					const first = exit.cause.reasons.find((reason) => !Cause.isInterruptReason(reason));
 					const code = failureText(first === void 0 ? void 0 : Cause.isFailReason(first) ? first.error : first.defect, "code", 128);
@@ -121,53 +521,435 @@ const makeLeakSafeEngineeringTracer = (delegate) => Tracer.make({
 	},
 	...delegate.context === void 0 ? {} : { context: delegate.context.bind(delegate) }
 });
+const MINIMAL_LOG_NAMES = /* @__PURE__ */ new Set([
+	"capxul_sdk_operation",
+	"identity.transition",
+	"convex.connection.changed",
+	"convex.action.connection_lost",
+	"cli.command.completed",
+	"cli.sdk.operation.failed",
+	"cli.wallet.step"
+]);
+const MINIMAL_ERROR_CODES = /* @__PURE__ */ new Set([
+	...CAPXUL_ERROR_CODES,
+	"CLI_USAGE",
+	"CLI_CONFIG",
+	"CLI_STORAGE",
+	"CLI_DEFECT"
+]);
+const MINIMAL_NUMBERS = /* @__PURE__ */ new Set([
+	"schema_version",
+	"duration_ms",
+	"wait_duration_ms",
+	"retry_count",
+	"http.status_code",
+	"http.response.status_code",
+	"http_status",
+	"rpc.code",
+	"connection_count",
+	"connection_retries",
+	"elapsed_ms",
+	"total_ms",
+	"token_calls",
+	"call",
+	"attempt",
+	"bridge_protocol_version",
+	"httpStatus"
+]);
+const MINIMAL_CORRELATIONS = /* @__PURE__ */ new Set([
+	"correlation_id",
+	"journey_id",
+	"invocation_id",
+	"posthogDistinctId"
+]);
+const MINIMAL_METRIC_LABELS = /* @__PURE__ */ new Set([
+	"command",
+	"capability",
+	"invocation_kind",
+	"outcome",
+	"capxul_env",
+	"unit"
+]);
+const MINIMAL_METRIC_NAMES = /* @__PURE__ */ new Set(["capxul.cli.command.count", "capxul.cli.command.duration"]);
+const traceId = (value) => typeof value === "string" && /^(?!0+$)[0-9a-f]{32}$/u.test(value);
+const spanId = (value) => typeof value === "string" && /^(?!0+$)[0-9a-f]{16}$/u.test(value);
+const minimalName = (value) => typeof value === "string" && (MINIMAL_LOG_NAMES.has(value) || isCapxulOperation(value) || CLI_COMMAND_NAMES.some((command) => value === `cli.command.${command}`)) ? value : "capxul.engineering";
+const MINIMAL_ENUM_VALUES = /* @__PURE__ */ new Map([
+	["outcome", [
+		"succeeded",
+		"refused",
+		"failed",
+		"cancelled",
+		"applied"
+	]],
+	["mode", FAILURE_MODES],
+	["failure_mode", FAILURE_MODES],
+	["capxul_env", ENGINEERING_CAPXUL_ENVS],
+	["producer", ["browser", "server"]],
+	["command", CLI_COMMAND_NAMES],
+	["capability", CLI_CAPABILITIES],
+	["invocation_kind", CLI_INVOCATION_KINDS],
+	["diagnostic_scope", [
+		"openfort.step",
+		"openfort.token",
+		"openfort.encryptionSession",
+		"openfort.embeddedState",
+		"openfort.storageCleared",
+		"openfort.configure",
+		"openfort.get",
+		"openfort.address",
+		"openfort.staleCacheHeal",
+		"openfort.signerRecovery",
+		"openfort.signerStatusListener"
+	]],
+	["step", [
+		"initialize",
+		"token",
+		"encryptionSession",
+		"embeddedState",
+		"configure",
+		"get",
+		"healStaleCache",
+		"walletReady"
+	]],
+	["provider", ["better-auth", "oidc"]],
+	["cli_identity_kind", ["anonymous", "identified"]],
+	["output_mode", ["human", "json"]],
+	["unit", [
+		"1",
+		"s",
+		"ms"
+	]]
+]);
+const MINIMAL_CODE_KEYS = /* @__PURE__ */ new Set([
+	"error.code",
+	"error_code",
+	"failure_code",
+	"refusal_code",
+	"capxul_error_code"
+]);
+const MINIMAL_VERSION_KEYS = /* @__PURE__ */ new Set([
+	"sdk_version",
+	"cli_version",
+	"release"
+]);
+function minimalStringValue(key, text) {
+	if (key === "operation") return isCapxulOperation(text);
+	if (MINIMAL_CODE_KEYS.has(key)) return MINIMAL_ERROR_CODES.has(text);
+	if (MINIMAL_VERSION_KEYS.has(key)) return /^[A-Za-z0-9][A-Za-z0-9._+@-]{0,127}$/u.test(text);
+	if (key === "trace_id") return traceId(text);
+	if (key === "span_id" || key === "parent_span_id") return spanId(text);
+	const values = MINIMAL_ENUM_VALUES.get(key);
+	if (values !== void 0) return values.includes(text);
+	return MINIMAL_CORRELATIONS.has(key) && /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/u.test(text) && !/^0x[0-9a-f]+$/iu.test(text) && redactSecrets(text) === text;
+}
+/** A named privacy projection, separate from the default credential-only redaction policy. */
+function minimalAttributes(attributes, metric = false) {
+	return attributes.flatMap(({ key, value }) => {
+		if (metric && !MINIMAL_METRIC_LABELS.has(key)) return [];
+		const text = value.stringValue;
+		const number = value.doubleValue ?? value.intValue;
+		if (MINIMAL_NUMBERS.has(key) && typeof number === "number" && Number.isFinite(number)) return [{
+			key,
+			value: { doubleValue: number }
+		}];
+		if (typeof text !== "string") return [];
+		return minimalStringValue(key, text) ? [{
+			key,
+			value: { stringValue: text }
+		}] : [];
+	});
+}
+const finiteProtocolNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : void 0;
+const protocolCount = (value, maximum = Number.MAX_SAFE_INTEGER) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0 && value <= maximum ? value : void 0;
+const protocolFlags = (value) => protocolCount(Object.getOwnPropertyDescriptor(value, "flags")?.value, 4294967295);
+function protocolTime(value) {
+	if (typeof value === "string" && /^\d{1,20}$/u.test(value) && BigInt(value) <= 18446744073709551615n) return value;
+	const number = protocolCount(value);
+	if (number !== void 0) return String(number);
+	if (value === null || typeof value !== "object") return void 0;
+	const low = protocolCount(Object.getOwnPropertyDescriptor(value, "low")?.value, 4294967295);
+	const high = protocolCount(Object.getOwnPropertyDescriptor(value, "high")?.value, 4294967295);
+	return low === void 0 || high === void 0 ? void 0 : (BigInt(high) << 32n | BigInt(low)).toString();
+}
+function minimalNumberPoints(points) {
+	return points.flatMap((point) => {
+		const attributes = minimalAttributes(point.attributes, true);
+		const asDouble = finiteProtocolNumber(point.asDouble);
+		const asInt = typeof point.asInt === "number" && Number.isSafeInteger(point.asInt) ? point.asInt : void 0;
+		if (attributes.length !== point.attributes.length || asDouble === void 0 && asInt === void 0) return [];
+		return [{
+			attributes,
+			timeUnixNano: protocolTime(point.timeUnixNano),
+			startTimeUnixNano: protocolTime(point.startTimeUnixNano),
+			asDouble,
+			asInt: asDouble === void 0 ? asInt : void 0,
+			flags: protocolFlags(point)
+		}];
+	});
+}
+function minimalHistogramPoints(points) {
+	return points.flatMap((point) => {
+		const attributes = minimalAttributes(point.attributes ?? [], true);
+		const count = protocolCount(point.count);
+		const bucketCounts = point.bucketCounts;
+		const explicitBounds = point.explicitBounds;
+		if (attributes.length !== (point.attributes?.length ?? 0) || count === void 0 || !Array.isArray(bucketCounts) || !bucketCounts.every((value) => protocolCount(value) !== void 0) || !Array.isArray(explicitBounds) || !explicitBounds.every((value) => finiteProtocolNumber(value) !== void 0) || bucketCounts.length !== explicitBounds.length + 1) return [];
+		return [{
+			attributes,
+			timeUnixNano: protocolTime(point.timeUnixNano),
+			startTimeUnixNano: protocolTime(point.startTimeUnixNano),
+			count,
+			sum: finiteProtocolNumber(point.sum),
+			min: finiteProtocolNumber(point.min),
+			max: finiteProtocolNumber(point.max),
+			bucketCounts: bucketCounts.map((value) => value),
+			explicitBounds: explicitBounds.map((value) => value),
+			flags: protocolFlags(point)
+		}];
+	});
+}
+function minimalSerialization(config) {
+	const service = config.serviceName ?? "capxul-sdk";
+	const resource = { attributes: Object.entries({
+		"service.name": service,
+		"service.version": config.sdkVersion,
+		sdk_version: config.sdkVersion,
+		capxul_env: config.capxulEnv,
+		producer: config.producer
+	}).map(([key, value]) => ({
+		key,
+		value: { stringValue: value }
+	})) };
+	return {
+		logs: (data) => HttpBody.jsonUnsafe({ resourceLogs: data.resourceLogs.map((entry) => ({
+			resource,
+			scopeLogs: entry.scopeLogs.map((scope) => ({
+				scope: { name: service },
+				logRecords: (scope.logRecords ?? []).map((record) => ({
+					timeUnixNano: protocolTime(record.timeUnixNano),
+					observedTimeUnixNano: protocolTime(record.observedTimeUnixNano),
+					severityNumber: protocolCount(record.severityNumber, 24),
+					severityText: [
+						"All",
+						"Trace",
+						"Debug",
+						"Info",
+						"Warn",
+						"Error",
+						"Fatal",
+						"None"
+					].includes(record.severityText ?? "") ? record.severityText : void 0,
+					body: { stringValue: minimalName(record.body?.stringValue) },
+					attributes: minimalAttributes(record.attributes),
+					droppedAttributesCount: protocolCount(record.droppedAttributesCount) ?? 0,
+					traceId: traceId(record.traceId) ? record.traceId : void 0,
+					spanId: spanId(record.spanId) ? record.spanId : void 0,
+					flags: protocolFlags(record)
+				}))
+			}))
+		})) }),
+		traces: (data) => HttpBody.jsonUnsafe({ resourceSpans: data.resourceSpans.map((entry) => ({
+			resource,
+			scopeSpans: entry.scopeSpans.map((scope) => ({
+				scope: { name: service },
+				spans: scope.spans.filter((span) => traceId(span.traceId) && spanId(span.spanId)).map((span) => {
+					const attributes = minimalAttributes(span.attributes);
+					const code = attributes.find((attribute) => attribute.key === "error.code");
+					return {
+						traceId: span.traceId,
+						spanId: span.spanId,
+						name: minimalName(span.name),
+						kind: protocolCount(span.kind, 5) ?? 0,
+						startTimeUnixNano: protocolTime(span.startTimeUnixNano),
+						endTimeUnixNano: protocolTime(span.endTimeUnixNano),
+						attributes,
+						droppedAttributesCount: protocolCount(span.droppedAttributesCount) ?? 0,
+						parentSpanId: spanId(span.parentSpanId) ? span.parentSpanId : void 0,
+						flags: protocolFlags(span),
+						status: { code: protocolCount(span.status.code, 2) ?? 0 },
+						events: span.events.slice(0, 8).map((event) => ({
+							timeUnixNano: protocolTime(event.timeUnixNano),
+							droppedAttributesCount: protocolCount(event.droppedAttributesCount) ?? 0,
+							name: event.name === "exception" ? "exception" : minimalName(event.name),
+							attributes: event.name === "exception" ? [{
+								key: "exception.type",
+								value: code?.value ?? { stringValue: "Error" }
+							}] : minimalAttributes(event.attributes)
+						})),
+						droppedEventsCount: protocolCount(span.droppedEventsCount) ?? 0,
+						links: span.links.filter((link) => traceId(link.traceId) && spanId(link.spanId)).slice(0, 8).map((link) => ({
+							traceId: link.traceId,
+							spanId: link.spanId,
+							flags: protocolFlags(link),
+							attributes: minimalAttributes(link.attributes),
+							droppedAttributesCount: protocolCount(link.droppedAttributesCount) ?? 0
+						})),
+						droppedLinksCount: protocolCount(span.droppedLinksCount) ?? 0
+					};
+				})
+			}))
+		})) }),
+		metrics: (data) => {
+			const resourceMetrics = data.resourceMetrics.map((entry) => ({
+				resource,
+				scopeMetrics: entry.scopeMetrics.map((scope) => ({
+					scope: { name: service },
+					metrics: scope.metrics.filter((metric) => MINIMAL_METRIC_NAMES.has(metric.name)).flatMap((metric) => {
+						const gauge = metric.gauge === void 0 ? void 0 : { dataPoints: minimalNumberPoints(metric.gauge.dataPoints) };
+						const sum = metric.sum === void 0 ? void 0 : {
+							aggregationTemporality: protocolCount(metric.sum.aggregationTemporality, 2) ?? 0,
+							isMonotonic: metric.sum.isMonotonic === true,
+							dataPoints: minimalNumberPoints(metric.sum.dataPoints)
+						};
+						const histogram = metric.histogram === void 0 ? void 0 : {
+							aggregationTemporality: protocolCount(metric.histogram.aggregationTemporality, 2) ?? 0,
+							dataPoints: minimalHistogramPoints(metric.histogram.dataPoints)
+						};
+						if (![
+							gauge,
+							sum,
+							histogram
+						].some((series) => (series?.dataPoints.length ?? 0) > 0)) return [];
+						return [{
+							name: metric.name,
+							unit: [
+								"1",
+								"s",
+								"ms"
+							].includes(metric.unit ?? "") ? metric.unit : "1",
+							...gauge === void 0 ? {} : { gauge },
+							...sum === void 0 ? {} : { sum },
+							...histogram === void 0 ? {} : { histogram }
+						}];
+					})
+				}))
+			}));
+			return resourceMetrics.some((entry) => entry.scopeMetrics.some((scope) => scope.metrics.length > 0)) ? HttpBody.jsonUnsafe({ resourceMetrics }) : HttpBody.empty;
+		}
+	};
+}
+/** Attempt to drain all engineering signals; completion does not prove ingestion. */
+const flushEngineeringTelemetry = Effect.flatMap(OtlpExporter.Flusher, (flusher) => flusher.flush);
+var EngineeringLog = class extends Context.Service()("capxul/EngineeringLog") {};
+/** Deliver an owned engineering record without changing the caller's console verbosity. */
+const logEngineeringInfo = (message, attributes) => {
+	const record = Effect.logInfo(message).pipe(Effect.annotateLogs(attributes));
+	return Effect.flatMap(LogLevel.isEnabled("Info"), (visible) => visible ? record : Effect.flatMap(Effect.serviceOption(EngineeringLog), (logger) => logger._tag === "None" ? Effect.void : record.pipe(Effect.provideService(Logger.CurrentLoggers, /* @__PURE__ */ new Set([logger.value])), Effect.provideService(References.MinimumLogLevel, "All"))));
+};
 /** Shared browser/server OTLP layer. OtlpLogger merges with incumbent loggers once. */
 const makeEngineeringTelemetryLayer = (config) => {
 	const validated = validateEngineeringTelemetryConfig(config);
-	const endpoints = postHogOtlpEndpoints(validated.host);
-	const resource = {
-		serviceName: validated.serviceName ?? "capxul-sdk",
-		serviceVersion: validated.sdkVersion,
-		attributes: {
-			capxul_env: validated.capxulEnv,
-			producer: validated.producer,
-			sdk_version: validated.sdkVersion
-		}
-	};
-	const tracing = Layer.effect(Tracer.Tracer, OtlpTracer.make({
-		url: endpoints.traces,
-		headers: validated.headers,
-		resource
-	}).pipe(Effect.map(makeLeakSafeEngineeringTracer))).pipe(Layer.provideMerge(OtlpExporter.layerFlusher));
-	const logging = OtlpLogger.layer({
-		url: endpoints.logs,
-		headers: validated.headers,
-		resource,
-		mergeWithExisting: true
-	});
-	const headerPolicy = Layer.merge(Layer.succeed(HttpClient.TracerHeaderFilter, traceHeaderFilter), Layer.succeed(Headers.CurrentRedactedNames, [credentialHeaderPattern]));
-	const browserLifecycle = Layer.effectDiscard(Effect.gen(function* () {
-		if (validated.producer !== "browser" || !hasBrowserDocument()) return;
-		const browserWindow = window;
-		const browserDocument = document;
-		const flusher = yield* OtlpExporter.Flusher;
-		const run = yield* FiberSet.makeRuntime();
-		const flush = () => {
-			run(flusher.flush);
+	return Layer.suspend(() => {
+		const bounded = validated.deliveryBudget === void 0 ? void 0 : cliEngineeringDelivery(validated.deliveryBudget, validated.serviceName === "capxul-cli");
+		const endpoints = postHogOtlpEndpoints(validated.host);
+		let disabled = false;
+		const enabled = () => {
+			if (disabled) return false;
+			try {
+				disabled = (typeof validated.enabled === "function" ? validated.enabled() : validated.enabled ?? true) !== true;
+			} catch {
+				disabled = true;
+			}
+			return !disabled;
+		};
+		const delivery = {
+			...validated.shutdownTimeout === void 0 ? {} : { shutdownTimeout: validated.shutdownTimeout },
+			...validated.exportInterval === void 0 ? {} : { exportInterval: validated.exportInterval },
+			...bounded === void 0 ? {} : {
+				maxBatchSize: Number.MAX_SAFE_INTEGER,
+				exportInterval: 1e3,
+				shutdownTimeout: validated.serviceName === "capxul-cli" ? 0 : 500
+			}
 		};
-		const visibilityChanged = () => {
-			if (browserDocument.visibilityState === "hidden") flush();
+		const resource = {
+			serviceName: validated.serviceName ?? "capxul-sdk",
+			serviceVersion: validated.sdkVersion,
+			attributes: {
+				capxul_env: validated.capxulEnv,
+				producer: validated.producer,
+				sdk_version: validated.sdkVersion
+			}
 		};
-		yield* Effect.acquireRelease(Effect.sync(() => {
-			browserDocument.addEventListener("visibilitychange", visibilityChanged);
-			browserWindow.addEventListener("pagehide", flush);
-		}), () => Effect.sync(() => {
-			browserDocument.removeEventListener("visibilitychange", visibilityChanged);
-			browserWindow.removeEventListener("pagehide", flush);
+		const tracing = Layer.effect(Tracer.Tracer, OtlpTracer.make({
+			url: endpoints.traces,
+			headers: validated.headers,
+			resource,
+			...delivery
+		}).pipe(Effect.map((tracer) => makeLeakSafeEngineeringTracer(bounded?.tracer(tracer) ?? tracer, enabled)))).pipe(Layer.provideMerge(OtlpExporter.layerFlusher));
+		const ownedLogging = Layer.effect(EngineeringLog, OtlpLogger.make({
+			url: endpoints.logs,
+			headers: validated.headers,
+			resource,
+			...delivery,
+			...bounded === void 0 ? {} : { excludeLogSpans: true }
+		}).pipe(Effect.map((nativeLogger) => {
+			const logger = bounded?.logger(nativeLogger) ?? nativeLogger;
+			return Logger.make((options) => {
+				if (enabled()) logger.log(options);
+			});
+		}))).pipe(Layer.provideMerge(OtlpExporter.layerFlusher));
+		const logging = Logger.layer([EngineeringLog], { mergeWithExisting: true }).pipe(Layer.provideMerge(ownedLogging));
+		const metricConfig = {
+			url: endpoints.metrics,
+			headers: validated.headers,
+			resource,
+			temporality: "delta",
+			...delivery
+		};
+		const metrics = bounded === void 0 ? OtlpMetrics.layer(metricConfig) : validated.serviceName !== "capxul-cli" ? Layer.empty : Layer.effectDiscard(Effect.gen(function* () {
+			const flusher = yield* OtlpExporter.Flusher;
+			yield* OtlpMetrics.make({
+				...metricConfig,
+				exportInterval: Number.POSITIVE_INFINITY,
+				shutdownTimeout: 0
+			}).pipe(Effect.provideService(OtlpExporter.Flusher, {
+				...flusher,
+				register: (run) => flusher.register(bounded.metrics(run))
+			}));
+		})).pipe(Layer.provideMerge(OtlpExporter.layerFlusher));
+		const headerPolicy = Layer.merge(Layer.succeed(HttpClient.TracerHeaderFilter, traceHeaderFilter), Layer.succeed(Headers.CurrentRedactedNames, [credentialHeaderPattern]));
+		const browserLifecycle = Layer.effectDiscard(Effect.gen(function* () {
+			if (validated.producer !== "browser" || !hasBrowserDocument()) return;
+			const browserWindow = window;
+			const browserDocument = document;
+			const flusher = yield* OtlpExporter.Flusher;
+			const run = yield* FiberSet.makeRuntime();
+			const flush = () => {
+				run(flusher.flush);
+			};
+			const visibilityChanged = () => {
+				if (browserDocument.visibilityState === "hidden") flush();
+			};
+			yield* Effect.acquireRelease(Effect.sync(() => {
+				browserDocument.addEventListener("visibilitychange", visibilityChanged);
+				browserWindow.addEventListener("pagehide", flush);
+			}), () => Effect.sync(() => {
+				browserDocument.removeEventListener("visibilitychange", visibilityChanged);
+				browserWindow.removeEventListener("pagehide", flush);
+			}));
 		}));
-	}));
-	const transport = Layer.effect(HttpClient.HttpClient, Effect.map(HttpClient.HttpClient, (client) => validated.producer === "browser" && hasBrowserDocument() ? browserExportClient(client) : client)).pipe(Layer.provide(FetchHttpClient.layer));
-	return browserLifecycle.pipe(Layer.provideMerge(Layer.mergeAll(tracing, logging, headerPolicy)), Layer.provide(OtlpSerialization.layerJson), Layer.provide(transport));
+		const transport = Layer.effect(HttpClient.HttpClient, Effect.map(HttpClient.HttpClient, (client) => {
+			const originalTransport = validated.producer === "browser" && hasBrowserDocument() ? browserExportClient(client) : client;
+			const selectedTransport = bounded?.transport(originalTransport, enabled) ?? originalTransport;
+			return HttpClient.transform(selectedTransport, (response, request) => Effect.suspend(() => {
+				if (enabled() && request.body._tag !== "Empty") return response;
+				bounded?.discardBody(request.body);
+				return Effect.succeed(HttpClientResponse.fromWeb(request, new Response(null, { status: 200 })));
+			}));
+		})).pipe(Layer.provide(FetchHttpClient.layer));
+		const serialization = Layer.effect(OtlpSerialization.OtlpSerialization, Effect.map(OtlpSerialization.OtlpSerialization, (json) => {
+			const projected = minimalSerialization(validated);
+			const selected = validated.privacy === "minimal" ? projected : {
+				...json,
+				metrics: projected.metrics
+			};
+			return bounded?.serialization(selected) ?? selected;
+		})).pipe(Layer.provide(OtlpSerialization.layerJson));
+		const combined = browserLifecycle.pipe(Layer.provideMerge(Layer.mergeAll(tracing, logging, metrics, headerPolicy)), Layer.provide(serialization), Layer.provide(transport));
+		const scoped = bounded === void 0 ? combined : combined.pipe(Layer.provideMerge(Layer.effectDiscard(Effect.addFinalizer(() => Effect.sync(bounded.close)))));
+		return validated.deliveryBudget === void 0 ? scoped : scoped.pipe(Layer.provideMerge(Layer.succeed(Metric.MetricRegistry, validated.serviceName === "capxul-cli" ? validated.deliveryBudget.metricRegistry : validated.deliveryBudget.emptyMetricRegistry())));
+	});
 };
 //#endregion
-export { ENGINEERING_CAPXUL_ENVS, makeEngineeringTelemetryLayer, makeLeakSafeEngineeringTracer, postHogOtlpEndpoints, traceHeaderFilter };
+export { CLI_ENGINEERING_LIMITS, ENGINEERING_CAPXUL_ENVS, flushEngineeringTelemetry, logEngineeringInfo, makeCliEngineeringBudget, makeEngineeringTelemetryLayer, makeLeakSafeEngineeringTracer, postHogOtlpEndpoints, traceHeaderFilter };