@capxul/observability 4.20.0-beta.3 → 4.20.0-beta.31

package/dist/engineering.mjs

@@ -1,8 +1,190 @@
-import { _ as CLI_COMMAND_NAMES, an as redactSecrets, en as isCapxulOperation, g as CLI_CAPABILITIES, in as isCredentialField, nn as CAPXUL_ERROR_CODES, on as redactUrlSecrets, rn as FAILURE_MODES, v as CLI_INVOCATION_KINDS } from "./src-CyMef9yy.mjs";
+import { I as CLI_CAPABILITIES, L as CLI_COMMAND_NAMES, R as CLI_INVOCATION_KINDS, an as isCapxulOperation, cn as ORGANIZATION_SETUP_STATUSES, dn as isCredentialField, fn as CAPXUL_ERROR_CODES, ln as redactSecrets, pn as FAILURE_MODES, sn as ORGANIZATION_SETUP_REASONS, un as redactUrlSecrets } from "./src-L9SjUzWV.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
+import { FetchHttpClient, Headers, HttpBody, HttpClient, HttpClientError, HttpClientResponse } from "effect/http";
+import { OtlpExporter, OtlpLogger, OtlpMetrics, OtlpSerialization, OtlpTracer } from "effect/observability";
+//#region ../protocol/src/primitives/record.ts
+/** A non-null object that is not an array: a value whose fields can be read by name. */
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** The field `key` of `value` when `value` is a record, else undefined. */
+function readField(value, key) {
+	return isRecord(value) ? value[key] : void 0;
+}
+//#endregion
+//#region src/delivery/admission.ts
+function newDeliveryState(budget, ownsMetrics) {
+	return {
+		budget,
+		ownsMetrics,
+		closed: Deferred.makeUnsafe(),
+		isClosed: false,
+		metricsRunning: false,
+		logs: [],
+		spans: /* @__PURE__ */ new Map(),
+		terminalBodies: /* @__PURE__ */ new WeakSet(),
+		bodyLeases: /* @__PURE__ */ new WeakMap(),
+		pendingBodies: /* @__PURE__ */ new Set()
+	};
+}
+/** Hold the records a body carries until its request finishes or the body is discarded. */
+function holdBody(state, body, releases) {
+	if (releases.length === 0) return;
+	const lease = {
+		started: false,
+		release: () => {
+			if (!state.pendingBodies.delete(lease)) return;
+			state.bodyLeases.delete(body);
+			for (const release of releases) release();
+		}
+	};
+	state.bodyLeases.set(body, lease);
+	state.pendingBodies.add(lease);
+}
+const discardBody = (state, body) => state.bodyLeases.get(body)?.release();
+const drainLogs = (state) => {
+	for (const release of state.logs.splice(0)) release();
+};
+function closeDelivery(state) {
+	state.isClosed = true;
+	Deferred.doneUnsafe(state.closed, Effect.void);
+	for (const lease of state.pendingBodies) if (!lease.started) lease.release();
+	drainLogs(state);
+	for (const release of state.spans.values()) release();
+	state.spans.clear();
+	if (state.ownsMetrics) state.budget.metricRegistry.clear();
+}
+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}`);
+//#endregion
+//#region src/delivery/records.ts
+function admittedLogger(state, delegate) {
+	return Logger.make((options) => {
+		if (state.isClosed) return;
+		let release;
+		try {
+			const message = text(Array.isArray(options.message) ? Object.getOwnPropertyDescriptor(options.message, "0")?.value : options.message);
+			release = state.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) });
+			state.logs.push(release);
+			delegate.log({
+				...options,
+				message,
+				cause: Cause.empty,
+				fiber
+			});
+		} catch {
+			if (release !== void 0) {
+				const index = state.logs.indexOf(release);
+				if (index !== -1) state.logs.splice(index, 1);
+				release();
+			}
+			state.budget.drop();
+		}
+	});
+}
+function admittedTracer(state, delegate) {
+	return Tracer.make({
+		span(options) {
+			const name = text(options.name);
+			const release = state.isClosed ? void 0 : state.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) state.spans.set(span.spanId, release);
+			const wrapped = boundedSpan(state, span);
+			wrapped.addLinks(options.links ?? []);
+			return wrapped;
+		},
+		...delegate.context === void 0 ? {} : { context: delegate.context.bind(delegate) }
+	});
+}
+/** The span as a producer sees it: at most 32 fields and 2000 attribute bytes, 2 events, 2 links. */
+function boundedSpan(state, span) {
+	const { budget } = state;
+	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);
+		} }
+	});
+	return wrapped;
+}
+//#endregion
+//#region src/delivery/budget.ts
 /** Fixed admission limits for one CLI invocation and its SDK client. */
 const CLI_ENGINEERING_LIMITS = Object.freeze({
 	records: 80,
@@ -52,9 +234,8 @@ var CliMetricRegistry = class extends Map {
 			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)) {
+		const buckets = readField(entry.hooks.get(Context.empty()), "buckets");
+		if (!["Counter", "Histogram"].includes(entry.type) || (entry.description?.length ?? 0) > 128 || labels.length > 6 || labels.some(([name, value]) => !metricValues[name]?.includes(value)) || entry.type === "Histogram" && (!Array.isArray(buckets) || buckets.length > 32)) {
 			this.dropped();
 			return this;
 		}
@@ -118,266 +299,123 @@ function makeCliEngineeringBudget() {
 		}
 	});
 }
-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" || 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);
+//#endregion
+//#region src/delivery/requests.ts
+function admittedSerialization(state, delegate) {
+	return {
+		logs(data) {
+			const releases = state.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 ?? ""))))) state.terminalBodies.add(body);
+				holdBody(state, body, releases);
+				return body;
+			} catch (error) {
 				for (const release of releases) release();
+				throw error;
 			}
-		};
-		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();
+		},
+		traces(data) {
+			const releases = [];
+			for (const resource of data.resourceSpans) for (const scope of resource.scopeSpans) for (const span of scope.spans) {
+				const release = state.spans.get(span.spanId);
+				if (release !== void 0) releases.push(release);
+				state.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))))) state.terminalBodies.add(body);
+				holdBody(state, body, releases);
+				return body;
+			} catch (error) {
+				for (const release of releases) release();
+				throw error;
+			}
+		},
+		metrics(data) {
+			const body = delegate.metrics(data);
+			state.terminalBodies.add(body);
+			return body;
+		}
 	};
+}
+/** A 429's Retry-After, bounded to two seconds; any other failure retries at once. */
+const retryAfter = 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);
+})));
+function admittedTransport(state, client, enabled = () => true) {
+	const { budget } = state;
+	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.catchReason("HttpClientError", "EmptyBodyError", () => Effect.void));
+	}))).pipe(HttpClient.filterStatusOk, HttpClient.retryTransient({
+		times: 1,
+		schedule: retryAfter
+	}));
+	return HttpClient.transform(retrying, (response, request) => Effect.suspend(() => {
+		if (state.isClosed) {
+			discardBody(state, 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(state, request.body);
+			return Effect.succeed(droppedResponse());
+		}
+		const bytes = request.body.contentLength;
+		const release = budget.admitRequest(bytes ?? Number.POSITIVE_INFINITY, state.terminalBodies.has(request.body));
+		if (release === void 0) {
+			discardBody(state, request.body);
+			return Effect.succeed(droppedResponse());
+		}
+		const lease = state.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(state.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(state, request.body);
+		})));
+	}));
+}
+//#endregion
+//#region src/engineering-delivery.ts
+/** Native exporters retain their serialization and scheduling; this owns admission only. */
+function cliEngineeringDelivery(budget, ownsMetrics) {
+	const state = newDeliveryState(budget, ownsMetrics);
 	return {
-		close,
-		discardBody,
+		close: () => closeDelivery(state),
+		discardBody: (body) => discardBody(state, body),
 		metrics(run) {
 			return Effect.suspend(() => {
-				if (isClosed || metricsRunning) return Effect.void;
-				metricsRunning = true;
+				if (state.isClosed || state.metricsRunning) return Effect.void;
+				state.metricsRunning = true;
 				return run.pipe(Effect.ensuring(Effect.sync(() => {
-					metricsRunning = false;
+					state.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) => l.body?.stringValue === "cli.command.completed")))) 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);
-				})));
-			}));
-		}
+		logger: (delegate) => admittedLogger(state, delegate),
+		tracer: (delegate) => admittedTracer(state, delegate),
+		serialization: (delegate) => admittedSerialization(state, delegate),
+		transport: (client, enabled) => admittedTransport(state, client, enabled)
 	};
 }
 //#endregion
-//#region src/engineering.ts
+//#region src/engineering/config.ts
 const ENGINEERING_CAPXUL_ENVS = [
 	"development",
 	"staging",
@@ -385,7 +423,10 @@ const ENGINEERING_CAPXUL_ENVS = [
 	"local"
 ];
 const traceHeaderFilter = (_name) => true;
-const credentialHeaderPattern = Object.assign(/./u, { test: (name) => isCredentialField(name, "header") });
+const credentialHeaderPattern = Object.assign(/./u, { exec: (name) => isCredentialField(name, "header") ? Object.assign([name], {
+	index: 0,
+	input: name
+}) : null });
 const postHogOtlpEndpoints = (host) => {
 	const base = host.replace(/\/+$/, "");
 	return {
@@ -424,6 +465,8 @@ const validateEngineeringTelemetryConfig = (config) => {
 		headers: Object.freeze({ authorization: headerEntries[0][1] })
 	};
 };
+//#endregion
+//#region src/engineering/tracer.ts
 const failureText = (failure, key, limit, source) => {
 	if (failure === null || typeof failure !== "object") return void 0;
 	try {
@@ -457,7 +500,7 @@ const browserExportClient = (client) => HttpClient.transform(client, (response,
 	if (request.body._tag === "Stream" || request.body._tag === "FormData" || bytes === void 0 || !Number.isSafeInteger(bytes) || bytes < 0 || unfinishedBrowserExportBytes + bytes > BROWSER_KEEPALIVE_BYTES) return;
 	unfinishedBrowserExportBytes += bytes;
 	return bytes;
-}), (bytes) => response.pipe(Effect.provideService(FetchHttpClient.RequestInit, { keepalive: bytes !== void 0 }), Effect.tap((result) => bytes === void 0 ? Effect.void : Stream.runDrain(result.stream).pipe(Effect.catch((error) => error.reason._tag === "EmptyBodyError" ? Effect.void : Effect.fail(error))))), (bytes) => Effect.sync(() => {
+}), (bytes) => response.pipe(Effect.provideService(FetchHttpClient.RequestInit, { keepalive: bytes !== void 0 }), Effect.tap((result) => bytes === void 0 ? Effect.void : Stream.runDrain(result.stream).pipe(Effect.catchIf((error) => error.reason._tag === "EmptyBodyError", () => Effect.void)))), (bytes) => Effect.sync(() => {
 	if (bytes !== void 0) unfinishedBrowserExportBytes -= bytes;
 })));
 const spanUpstream = (span) => {
@@ -477,11 +520,15 @@ function redactHttpPath(path, fullUrl, source) {
 	const prefix = path.startsWith("/") ? origin : "";
 	return redactUrlSecrets(`${prefix}${path}`, source).slice(prefix.length, prefix.length + 2048);
 }
+/** A span whose prototype is `span`: it answers every Span member until an own property overrides it. */
+function inheritSpan(span) {
+	return Object.create(span);
+}
 /** Preserve domain exits while preventing the OTLP serializer from seeing raw causes. */
 const makeLeakSafeEngineeringTracer = (delegate, enabled = () => true) => Tracer.make({
 	span(options) {
 		const span = enabled() ? delegate.span(options) : new Tracer.NativeSpan(options);
-		const wrapped = Object.create(span);
+		const wrapped = inheritSpan(span);
 		Object.defineProperty(wrapped, "attribute", { value: (name, value) => {
 			const source = spanUpstream(span);
 			const header = /^http\.(?:request|response)\.header\.(.+)$/u.exec(name)?.[1];
@@ -521,20 +568,25 @@ const makeLeakSafeEngineeringTracer = (delegate, enabled = () => true) => Tracer
 	},
 	...delegate.context === void 0 ? {} : { context: delegate.context.bind(delegate) }
 });
+//#endregion
+//#region src/engineering/minimal.ts
 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.sdk.operation.failed",
+	"cli.signer.wait",
+	"cli.wallet.step"
 ]);
 const MINIMAL_ERROR_CODES = /* @__PURE__ */ new Set([
 	...CAPXUL_ERROR_CODES,
 	"CLI_USAGE",
 	"CLI_CONFIG",
 	"CLI_STORAGE",
-	"CLI_DEFECT"
+	"CLI_DEFECT",
+	"CLI_DEADLINE"
 ]);
 const MINIMAL_NUMBERS = /* @__PURE__ */ new Set([
 	"schema_version",
@@ -546,7 +598,14 @@ const MINIMAL_NUMBERS = /* @__PURE__ */ new Set([
 	"http_status",
 	"rpc.code",
 	"connection_count",
-	"connection_retries"
+	"connection_retries",
+	"elapsed_ms",
+	"total_ms",
+	"token_calls",
+	"call",
+	"attempt",
+	"bridge_protocol_version",
+	"httpStatus"
 ]);
 const MINIMAL_CORRELATIONS = /* @__PURE__ */ new Set([
 	"correlation_id",
@@ -581,8 +640,39 @@ const MINIMAL_ENUM_VALUES = /* @__PURE__ */ new Map([
 	["command", CLI_COMMAND_NAMES],
 	["capability", CLI_CAPABILITIES],
 	["invocation_kind", CLI_INVOCATION_KINDS],
-	["cli_identity_kind", ["anonymous"]],
+	["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"]],
+	["setup_status", ORGANIZATION_SETUP_STATUSES],
+	["setup_reason", ORGANIZATION_SETUP_REASONS],
+	["signer_stage", [
+		"address",
+		"readiness",
+		"sign"
+	]],
 	["unit", [
 		"1",
 		"s",
@@ -603,6 +693,7 @@ const MINIMAL_VERSION_KEYS = /* @__PURE__ */ new Set([
 ]);
 function minimalStringValue(key, text) {
 	if (key === "operation") return isCapxulOperation(text);
+	if (key === "organization_id") return /^org_[0-9A-Za-z]+$/u.test(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);
@@ -628,6 +719,8 @@ function minimalAttributes(attributes, metric = false) {
 		}] : [];
 	});
 }
+//#endregion
+//#region src/engineering/metric-points.ts
 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);
@@ -677,6 +770,8 @@ function minimalHistogramPoints(points) {
 		}];
 	});
 }
+//#endregion
+//#region src/engineering/serialization.ts
 function minimalSerialization(config) {
 	const service = config.serviceName ?? "capxul-sdk";
 	const resource = { attributes: Object.entries({
@@ -767,7 +862,7 @@ function minimalSerialization(config) {
 						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,
+							isMonotonic: metric.sum.isMonotonic,
 							dataPoints: minimalNumberPoints(metric.sum.dataPoints)
 						};
 						const histogram = metric.histogram === void 0 ? void 0 : {
@@ -797,14 +892,18 @@ function minimalSerialization(config) {
 		}
 	};
 }
+//#endregion
+//#region src/engineering/logs.ts
 /** 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(EngineeringLog, (logger) => record.pipe(Effect.provideService(Logger.CurrentLoggers, /* @__PURE__ */ new Set([logger])), Effect.provideService(References.MinimumLogLevel, "All"))));
+	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"))));
 };
+//#endregion
+//#region src/engineering.ts
 /** Shared browser/server OTLP layer. OtlpLogger merges with incumbent loggers once. */
 const makeEngineeringTelemetryLayer = (config) => {
 	const validated = validateEngineeringTelemetryConfig(config);