@lmnr-ai/lmnr 0.8.44 → 0.8.45

package/dist/{dist-Cjres0a5.mjs → utils-UmlDPMxe.mjs}

@@ -1,10 +1,10 @@
-import { TraceFlags } from "@opentelemetry/api";
 import { config } from "dotenv";
 import * as path from "path";
 import pino from "pino";
 import { PinoPretty } from "pino-pretty";
-import { fileURLToPath } from "url";
 import { v4 } from "uuid";
+import { TraceFlags } from "@opentelemetry/api";
+import { fileURLToPath } from "url";
 //#region ../types/dist/index.mjs
 /** Directory the debug-session file lives in, relative to the working dir. */
 const DEBUG_SESSION_DIR = ".lmnr";
@@ -25,42 +25,128 @@ let TracingLevel = /* @__PURE__ */ function(TracingLevel) {
 }({});
 const errorMessage = (error) => error instanceof Error ? error.message : String(error);
 //#endregion
-//#region package.json
-var version$1 = "0.8.44";
-//#endregion
-//#region src/opentelemetry-lib/tracing/attributes.ts
-const SPAN_INPUT = "lmnr.span.input";
-const SPAN_OUTPUT = "lmnr.span.output";
-const SPAN_TYPE = "lmnr.span.type";
-const SPAN_PATH = "lmnr.span.path";
-const SPAN_IDS_PATH = "lmnr.span.ids_path";
-const PARENT_SPAN_PATH = "lmnr.span.parent_path";
-const PARENT_SPAN_IDS_PATH = "lmnr.span.parent_ids_path";
-const SPAN_INSTRUMENTATION_SOURCE = "lmnr.span.instrumentation_source";
-const SPAN_SDK_VERSION = "lmnr.span.sdk_version";
-const SPAN_LANGUAGE_VERSION = "lmnr.span.language_version";
-const SPAN_INSTRUMENTATION_SCOPE_NAME = "lmnr.span.instrumentation_scope.name";
-const SPAN_INSTRUMENTATION_SCOPE_VERSION = "lmnr.span.instrumentation_scope.version";
-const TRACE_HAS_BROWSER_SESSION = "lmnr.internal.has_browser_session";
-const HUMAN_EVALUATOR_OPTIONS = "lmnr.span.human_evaluator_options";
-const ASSOCIATION_PROPERTIES = "lmnr.association.properties";
-const SESSION_ID = "lmnr.association.properties.session_id";
-const USER_ID = "lmnr.association.properties.user_id";
-const TRACE_TYPE = "lmnr.association.properties.trace_type";
-const ASSOCIATION_PROPERTIES_OVERRIDES = { "span_type": SPAN_TYPE };
-const LaminarAttributes = {
-	INPUT_TOKEN_COUNT: "gen_ai.usage.input_tokens",
-	OUTPUT_TOKEN_COUNT: "gen_ai.usage.output_tokens",
-	TOTAL_TOKEN_COUNT: "llm.usage.total_tokens",
-	PROVIDER: "gen_ai.system",
-	REQUEST_MODEL: "gen_ai.request.model",
-	RESPONSE_MODEL: "gen_ai.response.model",
-	INPUT_COST: "gen_ai.usage.input_cost",
-	OUTPUT_COST: "gen_ai.usage.output_cost",
-	TOTAL_COST: "gen_ai.usage.cost"
+//#region ../client/dist/index.mjs
+var version$1 = "0.8.45";
+function getLangVersion() {
+	if (typeof process !== "undefined" && process.versions && process.versions.node) return `node-${process.versions.node}`;
+	if (typeof navigator !== "undefined" && navigator.userAgent) return `browser-${navigator.userAgent}`;
+	return null;
+}
+var BaseResource = class {
+	constructor(baseHttpUrl, auth) {
+		this.baseHttpUrl = baseHttpUrl;
+		this.auth = auth;
+		this.credential = auth.type === "apiKey" ? auth.key : auth.token;
+	}
+	/** API path prefix: `/v1/cli` for CLI user-token auth, `/v1` otherwise. */
+	get apiPrefix() {
+		return this.auth.type === "userToken" ? "/v1/cli" : "/v1";
+	}
+	headers() {
+		return {
+			Authorization: `Bearer ${this.credential}`,
+			"Content-Type": "application/json",
+			Accept: "application/json",
+			...this.auth.type === "userToken" ? { "x-lmnr-project-id": this.auth.projectId } : {}
+		};
+	}
+	async handleError(response) {
+		const errorMsg = await response.text();
+		throw new Error(`${response.status} ${errorMsg}`);
+	}
+};
+var BrowserEventsResource = class extends BaseResource {
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
+	}
+	async send({ sessionId, traceId, events }) {
+		const payload = {
+			sessionId,
+			traceId,
+			events,
+			source: getLangVersion() ?? "javascript",
+			sdkVersion: version$1
+		};
+		const jsonString = JSON.stringify(payload);
+		const compressedStream = new Blob([jsonString], { type: "application/json" }).stream().pipeThrough(new CompressionStream("gzip"));
+		const compressedData = await new Response(compressedStream).arrayBuffer();
+		const response = await fetch(this.baseHttpUrl + "/v1/browser-sessions/events", {
+			method: "POST",
+			headers: {
+				...this.headers(),
+				"Content-Encoding": "gzip"
+			},
+			body: compressedData
+		});
+		if (!response.ok) await this.handleError(response);
+	}
+};
+/**
+* Locale-aware, case-insensitive comparator for the project listing. Ordering
+* lives here — the single choke point every CLI surface (the `project list`
+* table + its `--json`, and the interactive picker used by `setup` / `plugin
+* add`) reads from — so the order can't drift between surfaces.
+*/
+const projectCollator = new Intl.Collator(void 0, { sensitivity: "base" });
+/** Sort projects by workspace name, then project name (stable, human-scannable). */
+const sortProjects = (projects) => [...projects].sort((a, b) => projectCollator.compare(a.workspaceName ?? "", b.workspaceName ?? "") || projectCollator.compare(a.name ?? "", b.name ?? ""));
+/**
+* User-scoped CLI endpoints that don't target a specific project. Authed by the
+* BetterAuth user JWT (the `credential`); deliberately does NOT send an
+* `x-lmnr-project-id` header (these routes are project discovery, pre-selection).
+*
+* Discovery exception: this resource always hits `/v1/cli/projects` with the
+* bare bearer and overrides `BaseResource.headers()`/`apiPrefix`, so it works
+* even when constructed with a `userToken` auth that has no real project id yet.
+*/
+var CliResource = class extends BaseResource {
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
+	}
+	/** Workspaces + projects the authenticated user can access. */
+	async listProjects() {
+		const response = await fetch(`${this.baseHttpUrl}/v1/cli/projects`, {
+			method: "GET",
+			headers: {
+				Authorization: `Bearer ${this.credential}`,
+				Accept: "application/json"
+			}
+		});
+		if (!response.ok) await this.handleError(response);
+		const body = await response.json();
+		return Array.isArray(body?.projects) ? sortProjects(body.projects) : [];
+	}
+	/**
+	* Resolve which project a project API key belongs to. Authed by the user JWT
+	* (the bearer); the project key travels in the body, NOT in `Authorization`.
+	* The server verifies the key and that the authenticated user is a member of
+	* the resolved project. Returns a tri-state probe so callers can distinguish a
+	* revoked key (401 → `invalid`) from a server/access problem (`unverifiable`).
+	*/
+	async resolveProjectByApiKey(apiKey) {
+		let response;
+		try {
+			response = await fetch(`${this.baseHttpUrl}/v1/cli/project`, {
+				method: "POST",
+				headers: {
+					Authorization: `Bearer ${this.credential}`,
+					"Content-Type": "application/json",
+					Accept: "application/json"
+				},
+				body: JSON.stringify({ apiKey })
+			});
+		} catch {
+			return { status: "unverifiable" };
+		}
+		if (response.status === 401) return { status: "invalid" };
+		if (!response.ok) return { status: "unverifiable" };
+		const body = await response.json().catch(() => null);
+		return body?.projectId ? {
+			status: "ok",
+			projectId: body.projectId
+		} : { status: "unverifiable" };
+	}
 };
-//#endregion
-//#region src/utils.ts
 function initializeLogger$1(options) {
 	const colorize = options?.colorize ?? true;
 	const level = options?.level ?? process.env.LMNR_LOG_LEVEL?.toLowerCase()?.trim() ?? "info";
@@ -69,29 +155,18 @@ function initializeLogger$1(options) {
 		minimumLevel: level
 	}));
 }
-const logger$5 = initializeLogger$1();
+const logger$4 = initializeLogger$1();
 const isStringUUID$1 = (id) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(id);
-const NIL_UUID = "00000000-0000-0000-0000-000000000000";
 const newUUID$1 = () => {
 	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
 	else return v4();
 };
-const normalizeOtelTraceId = (traceId) => {
-	let id = traceId.toLowerCase();
-	if (id.startsWith("0x")) id = id.slice(2);
-	return id.padStart(32, "0").slice(-32);
-};
-const normalizeOtelSpanId = (spanId) => {
-	let id = spanId.toLowerCase();
-	if (id.startsWith("0x")) id = id.slice(2);
-	return id.padStart(16, "0").slice(-16);
-};
 const otelSpanIdToUUID$1 = (spanId) => {
 	let id = spanId.toLowerCase();
 	if (id.startsWith("0x")) id = id.slice(2);
-	if (id.length !== 16) logger$5.warn(`Span ID ${spanId} is not 16 hex chars long. This is not a valid OpenTelemetry span ID.`);
+	if (id.length !== 16) logger$4.warn(`Span ID ${spanId} is not 16 hex chars long. This is not a valid OpenTelemetry span ID.`);
 	if (!/^[0-9a-f]+$/.test(id)) {
-		logger$5.error(`Span ID ${spanId} is not a valid hex string. Generating a random UUID instead.`);
+		logger$4.error(`Span ID ${spanId} is not a valid hex string. Generating a random UUID instead.`);
 		return newUUID$1();
 	}
 	return id.padStart(32, "0").replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
@@ -99,481 +174,70 @@ const otelSpanIdToUUID$1 = (spanId) => {
 const otelTraceIdToUUID$1 = (traceId) => {
 	let id = traceId.toLowerCase();
 	if (id.startsWith("0x")) id = id.slice(2);
-	if (id.length !== 32) logger$5.warn(`Trace ID ${traceId} is not 32 hex chars long. This is not a valid OpenTelemetry trace ID.`);
+	if (id.length !== 32) logger$4.warn(`Trace ID ${traceId} is not 32 hex chars long. This is not a valid OpenTelemetry trace ID.`);
 	if (!/^[0-9a-f]+$/.test(id)) {
-		logger$5.error(`Trace ID ${traceId} is not a valid hex string. Generating a random UUID instead.`);
+		logger$4.error(`Trace ID ${traceId} is not a valid hex string. Generating a random UUID instead.`);
 		return newUUID$1();
 	}
 	return id.replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
 };
-const uuidToOtelTraceId = (uuid) => uuid.replace(/-/g, "");
-const uuidToOtelSpanId = (uuid) => uuid.replace(/-/g, "").slice(16);
-/**
-* This is a simple implementation of a semaphore to replicate
-* the behavior of the `asyncio.Semaphore` in Python.
-*/
-var Semaphore = class {
-	constructor(value = 1) {
-		this._waiters = [];
-		if (value < 0) throw new Error("Semaphore value must be >= 0");
-		this._value = value;
-		this._waiters = [];
+const slicePayload = (value, length) => {
+	if (value === null || value === void 0) return value;
+	const str = JSON.stringify(value);
+	if (str.length <= length) return value;
+	return str.slice(0, length) + "...";
+};
+const loadEnv$1 = (options) => {
+	const nodeEnv = process.env.NODE_ENV || "development";
+	const envDir = process.cwd();
+	const envFiles = [
+		".env",
+		".env.local",
+		`.env.${nodeEnv}`,
+		`.env.${nodeEnv}.local`
+	];
+	const logLevel = process.env.LMNR_LOG_LEVEL ?? "info";
+	const verbose = ["debug", "trace"].includes(logLevel.trim().toLowerCase());
+	const quiet = options?.quiet ?? !verbose;
+	config({
+		path: options?.paths ?? envFiles.map((envFile) => path.resolve(envDir, envFile)),
+		quiet
+	});
+};
+const logger$3 = initializeLogger$1();
+const DEFAULT_DATASET_PULL_LIMIT = 100;
+const DEFAULT_DATASET_PUSH_BATCH_SIZE = 100;
+var DatasetsResource = class extends BaseResource {
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
-	async acquire() {
-		if (this._value > 0) {
-			this._value--;
-			return;
-		}
-		return new Promise((resolve) => {
-			this._waiters.push(resolve);
+	/**
+	* List all datasets.
+	*
+	* @returns {Promise<Dataset[]>} Array of datasets
+	*/
+	async listDatasets() {
+		const response = await fetch(this.baseHttpUrl + this.apiPrefix + "/datasets", {
+			method: "GET",
+			headers: this.headers()
 		});
+		if (!response.ok) await this.handleError(response);
+		return response.json();
 	}
-	release() {
-		if (this._waiters.length > 0) this._waiters.shift()?.();
-		else this._value++;
-	}
-	async using(fn) {
-		try {
-			await this.acquire();
-			return await fn();
-		} finally {
-			this.release();
-		}
-	}
-};
-const tryToOtelSpanContext = (spanContext) => {
-	if (typeof spanContext === "string") try {
-		return recordToOtelSpanContext(JSON.parse(spanContext));
-	} catch (e) {
-		throw new Error(`Failed to parse span context ${spanContext}. The string must be a json representation of a LaminarSpanContext.Error: ${errorMessage(e)}`);
-	}
-	else if (isRecord(spanContext)) return recordToOtelSpanContext(spanContext);
-	else if (typeof spanContext.traceId === "string" && typeof spanContext.spanId === "string" && spanContext.traceId.length === 32 && spanContext.spanId.length === 16) {
-		logger$5.warn("The span context is already an OpenTelemetry SpanContext. Returning it as is. Please use `LaminarSpanContext` objects instead.");
-		return spanContext;
-	} else throw new Error(`Invalid span context ${JSON.stringify(spanContext)}. Must be a LaminarSpanContext or its json representation.`);
-};
-const recordToOtelSpanContext = (record) => {
-	if (typeof record.spanId === "string" && typeof record.traceId === "string" || typeof record.span_id === "string" && typeof record.trace_id === "string") return {
-		spanId: uuidToOtelSpanId(record?.spanId ?? record?.["span_id"]),
-		traceId: uuidToOtelTraceId(record?.traceId ?? record?.["trace_id"]),
-		isRemote: record?.isRemote ?? record?.["is_remote"] ?? false,
-		traceFlags: record?.traceFlags ?? TraceFlags.SAMPLED
-	};
-	else throw new Error(`Invalid span context ${JSON.stringify(record)}. Must be a json representation of a LaminarSpanContext.`);
-};
-const isRecord = (value) => typeof value === "object" && !Array.isArray(value) && value !== null;
-/**
-* Deserialize a LaminarSpanContext from a string or record.
-* Handles both camelCase and snake_case keys for cross-language compatibility.
-*
-* @param data - The data to deserialize (string or record)
-* @returns The deserialized LaminarSpanContext
-* @throws Error if the data is invalid
-*/
-const deserializeLaminarSpanContext = (data) => {
-	if (typeof data === "string") try {
-		return deserializeLaminarSpanContext(JSON.parse(data));
-	} catch (e) {
-		throw new Error(`Failed to parse LaminarSpanContext: ${errorMessage(e)}`);
-	}
-	if (!isRecord(data)) throw new Error("Invalid LaminarSpanContext: must be a string or object");
-	const traceId = data.traceId ?? data.trace_id;
-	const spanId = data.spanId ?? data.span_id;
-	const isRemote = data.isRemote ?? data.is_remote ?? false;
-	const spanPath = data.spanPath ?? data.span_path;
-	const spanIdsPath = data.spanIdsPath ?? data.span_ids_path;
-	const userId = data.userId ?? data.user_id;
-	const sessionId = data.sessionId ?? data.session_id;
-	const metadata = data.metadata;
-	const traceType = data.traceType ?? data.trace_type;
-	const tracingLevel = data.tracingLevel ?? data.tracing_level;
-	const debug = data.debug;
-	if (typeof traceId !== "string" || typeof spanId !== "string") throw new Error("Invalid LaminarSpanContext: traceId and spanId must be strings");
-	if (!isStringUUID$1(traceId) || !isStringUUID$1(spanId)) throw new Error("Invalid LaminarSpanContext: traceId and spanId must be valid UUIDs");
-	return {
-		traceId,
-		spanId,
-		isRemote: Boolean(isRemote),
-		spanPath: Array.isArray(spanPath) ? spanPath : void 0,
-		spanIdsPath: Array.isArray(spanIdsPath) ? spanIdsPath : void 0,
-		userId,
-		sessionId,
-		metadata,
-		traceType,
-		tracingLevel,
-		debug: isRecord(debug) ? deserializeDebugContext(debug) : void 0
-	};
-};
-/**
-* Normalize a value to a canonical lowercase UUID string, or undefined.
-*
-* The debug block's `sessionId` / `replayTraceId` are always full ids; a value
-* that isn't UUID-shaped is dropped (treated as absent) rather than thrown, so
-* a partially-broken block never breaks span-context parsing.
-*/
-const asString = (value) => typeof value === "string" && value.length > 0 ? value : void 0;
-/**
-* Parse a debug block, accepting camelCase and snake_case. All ids are kept
-* VERBATIM: the producer emits the run's exact session / replay-trace /
-* cache-until strings (un-normalized — `LMNR_DEBUG_SESSION_ID` may be an
-* arbitrary non-UUID value), so the consumer must round-trip them unchanged or
-* a downstream run never joins the run. Keep line-comparable with the Python
-* `DebugContext.deserialize`.
-*/
-const deserializeDebugContext = (data) => ({
-	enabled: data.enabled === true,
-	sessionId: asString(data.sessionId ?? data.session_id),
-	replayTraceId: asString(data.replayTraceId ?? data.replay_trace_id),
-	cacheUntil: asString(data.cacheUntil ?? data.cache_until)
-});
-const getDirname = () => {
-	if (typeof __dirname !== "undefined") return __dirname;
-	if (typeof import.meta.url !== "undefined") return path.dirname(fileURLToPath(import.meta.url));
-	return process.cwd();
-};
-const MAX_MANUAL_SPAN_PAYLOAD_SIZE = 1024 * 1024 * 10;
-const TRUNCATION_SUFFIX = "...[Laminar: truncated]";
-/**
-* Cut an oversized span payload down to the limit rather than dropping it.
-*
-* Keeping the leading bytes preserves the start of the value, which is the useful part when
-* debugging. Mirrors `_truncate_payload` in the Python SDK.
-*
-* Callers pass the result of `JSON.stringify`, whose TS signature claims `string` but which
-* actually returns `undefined` for a top-level `undefined`, function, or symbol. Guard at
-* runtime and hand such values straight back: `setAttribute` treats them as a no-op, which is
-* the behaviour these payloads had before truncation existed.
-*/
-const truncateSpanPayload = (serialized, kind) => {
-	if (typeof serialized !== "string") return serialized;
-	if (serialized.length <= 10485760) return serialized;
-	logger$5.warn(`Laminar: span ${kind} is ${serialized.length} bytes, which exceeds the ${MAX_MANUAL_SPAN_PAYLOAD_SIZE} byte limit. Truncating to the limit; the recorded value will not be valid JSON.`);
-	const keep = MAX_MANUAL_SPAN_PAYLOAD_SIZE - 23;
-	return serialized.slice(0, keep) + TRUNCATION_SUFFIX;
-};
-const isOtelAttributeValueType = (value) => {
-	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return true;
-	if (Array.isArray(value)) {
-		const allStrings = value.every((value) => value == null || typeof value === "string");
-		const allNumbers = value.every((value) => value == null || typeof value === "number");
-		const allBooleans = value.every((value) => value == null || typeof value === "boolean");
-		return allStrings || allNumbers || allBooleans;
-	}
-	return false;
-};
-const metadataToAttributes = (metadata) => Object.fromEntries(Object.entries(metadata).map(([key, value]) => {
-	if (isOtelAttributeValueType(value)) return [`${ASSOCIATION_PROPERTIES}.metadata.${key}`, value];
-	else return [`${ASSOCIATION_PROPERTIES}.metadata.${key}`, JSON.stringify(value)];
-}));
-/**
-* Get OTEL environment variable with priority order.
-* Checks in order:
-* 1. OTEL_EXPORTER_OTLP_TRACES_{varName}
-* 2. OTEL_EXPORTER_OTLP_{varName}
-* 3. OTEL_{varName}
-*
-* @param varName - The variable name (e.g., 'ENDPOINT', 'HEADERS', 'PROTOCOL')
-* @returns The environment variable value or undefined if not found
-*/
-const getOtelEnvVar = (varName) => {
-	const candidates = [
-		`OTEL_EXPORTER_OTLP_TRACES_${varName}`,
-		`OTEL_EXPORTER_OTLP_${varName}`,
-		`OTEL_${varName}`
-	];
-	for (const candidate of candidates) {
-		const value = process?.env?.[candidate];
-		if (value) return value;
-	}
-};
-/**
-* Check if OTEL configuration is available.
-* @returns true if OTEL endpoint is configured
-*/
-const hasOtelConfig = () => !!getOtelEnvVar("ENDPOINT");
-/**
-* Parse OTEL headers string into a record object.
-* Format: key1=value1,key2=value2
-* Values are URL-decoded.
-*
-* @param headersStr - Headers string in OTEL format
-* @returns Parsed headers object
-*/
-const parseOtelHeaders = (headersStr) => {
-	if (!headersStr) return {};
-	const headers = {};
-	for (const pair of headersStr.split(",")) {
-		const equalIndex = pair.indexOf("=");
-		if (equalIndex !== -1) {
-			const key = pair.substring(0, equalIndex).trim();
-			const value = pair.substring(equalIndex + 1).trim();
-			headers[key] = decodeURIComponent(value);
-		}
-	}
-	return headers;
-};
-/**
-* Validate that either Laminar API key or OTEL configuration is present.
-* Throws an error if neither is configured.
-*
-* @param apiKey - The Laminar API key (if provided)
-* @throws Error if neither API key nor OTEL configuration is present
-*/
-const validateTracingConfig = (apiKey) => {
-	if (!apiKey && !hasOtelConfig()) throw new Error("Please initialize the Laminar object with your project API key or set the LMNR_PROJECT_API_KEY environment variable, or configure OTEL environment variables (OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, etc.)");
-};
-const loadEnv$1 = (options) => {
-	const nodeEnv = process.env.NODE_ENV || "development";
-	const envDir = process.cwd();
-	const envFiles = [
-		".env",
-		".env.local",
-		`.env.${nodeEnv}`,
-		`.env.${nodeEnv}.local`
-	];
-	const logLevel = process.env.LMNR_LOG_LEVEL ?? "info";
-	const verbose = ["debug", "trace"].includes(logLevel.trim().toLowerCase());
-	const quiet = options?.quiet ?? !verbose;
-	config({
-		path: options?.paths ?? envFiles.map((envFile) => path.resolve(envDir, envFile)),
-		quiet
-	});
-};
-/**
-* Converts an API base URL to the frontend/web URL.
-* - Converts https://api.lmnr.ai to https://www.laminar.sh
-* - Removes trailing slashes
-* - For localhost/127.0.0.1, ensures a port is specified (defaults to 5667)
-*
-* @param baseUrl - The API base URL (defaults to "https://api.lmnr.ai")
-* @returns The frontend URL
-*/
-const getFrontendUrl = (baseUrl, frontendPort) => {
-	let url = baseUrl ?? "https://api.lmnr.ai";
-	if (url === "https://api.lmnr.ai") url = "https://www.laminar.sh";
-	url = url.replace(/\/$/, "");
-	if (/localhost|127\.0\.0\.1/.test(url)) {
-		const port = frontendPort ?? url.match(/:\d{1,5}$/g)?.[0]?.slice(1) ?? 5667;
-		if (/:(\d{1,5})$/.test(url)) url = url.replace(/:\d{1,5}$/g, `:${port}`);
-		else url = `${url}:${port}`;
-	}
-	return url;
-};
-//#endregion
-//#region ../client/dist/index.mjs
-var version = "0.8.44";
-function getLangVersion() {
-	if (typeof process !== "undefined" && process.versions && process.versions.node) return `node-${process.versions.node}`;
-	if (typeof navigator !== "undefined" && navigator.userAgent) return `browser-${navigator.userAgent}`;
-	return null;
-}
-var BaseResource = class {
-	constructor(baseHttpUrl, auth) {
-		this.baseHttpUrl = baseHttpUrl;
-		this.auth = auth;
-		this.credential = auth.type === "apiKey" ? auth.key : auth.token;
-	}
-	/** API path prefix: `/v1/cli` for CLI user-token auth, `/v1` otherwise. */
-	get apiPrefix() {
-		return this.auth.type === "userToken" ? "/v1/cli" : "/v1";
-	}
-	headers() {
-		return {
-			Authorization: `Bearer ${this.credential}`,
-			"Content-Type": "application/json",
-			Accept: "application/json",
-			...this.auth.type === "userToken" ? { "x-lmnr-project-id": this.auth.projectId } : {}
-		};
-	}
-	async handleError(response) {
-		const errorMsg = await response.text();
-		throw new Error(`${response.status} ${errorMsg}`);
-	}
-};
-var BrowserEventsResource = class extends BaseResource {
-	constructor(baseHttpUrl, auth) {
-		super(baseHttpUrl, auth);
-	}
-	async send({ sessionId, traceId, events }) {
-		const payload = {
-			sessionId,
-			traceId,
-			events,
-			source: getLangVersion() ?? "javascript",
-			sdkVersion: version
-		};
-		const jsonString = JSON.stringify(payload);
-		const compressedStream = new Blob([jsonString], { type: "application/json" }).stream().pipeThrough(new CompressionStream("gzip"));
-		const compressedData = await new Response(compressedStream).arrayBuffer();
-		const response = await fetch(this.baseHttpUrl + "/v1/browser-sessions/events", {
-			method: "POST",
-			headers: {
-				...this.headers(),
-				"Content-Encoding": "gzip"
-			},
-			body: compressedData
-		});
-		if (!response.ok) await this.handleError(response);
-	}
-};
-/**
-* Locale-aware, case-insensitive comparator for the project listing. Ordering
-* lives here — the single choke point every CLI surface (the `project list`
-* table + its `--json`, and the interactive picker used by `setup` / `plugin
-* add`) reads from — so the order can't drift between surfaces.
-*/
-const projectCollator = new Intl.Collator(void 0, { sensitivity: "base" });
-/** Sort projects by workspace name, then project name (stable, human-scannable). */
-const sortProjects = (projects) => [...projects].sort((a, b) => projectCollator.compare(a.workspaceName ?? "", b.workspaceName ?? "") || projectCollator.compare(a.name ?? "", b.name ?? ""));
-/**
-* User-scoped CLI endpoints that don't target a specific project. Authed by the
-* BetterAuth user JWT (the `credential`); deliberately does NOT send an
-* `x-lmnr-project-id` header (these routes are project discovery, pre-selection).
-*
-* Discovery exception: this resource always hits `/v1/cli/projects` with the
-* bare bearer and overrides `BaseResource.headers()`/`apiPrefix`, so it works
-* even when constructed with a `userToken` auth that has no real project id yet.
-*/
-var CliResource = class extends BaseResource {
-	constructor(baseHttpUrl, auth) {
-		super(baseHttpUrl, auth);
-	}
-	/** Workspaces + projects the authenticated user can access. */
-	async listProjects() {
-		const response = await fetch(`${this.baseHttpUrl}/v1/cli/projects`, {
-			method: "GET",
-			headers: {
-				Authorization: `Bearer ${this.credential}`,
-				Accept: "application/json"
-			}
-		});
-		if (!response.ok) await this.handleError(response);
-		const body = await response.json();
-		return Array.isArray(body?.projects) ? sortProjects(body.projects) : [];
-	}
-	/**
-	* Resolve which project a project API key belongs to. Authed by the user JWT
-	* (the bearer); the project key travels in the body, NOT in `Authorization`.
-	* The server verifies the key and that the authenticated user is a member of
-	* the resolved project. Returns a tri-state probe so callers can distinguish a
-	* revoked key (401 → `invalid`) from a server/access problem (`unverifiable`).
-	*/
-	async resolveProjectByApiKey(apiKey) {
-		let response;
-		try {
-			response = await fetch(`${this.baseHttpUrl}/v1/cli/project`, {
-				method: "POST",
-				headers: {
-					Authorization: `Bearer ${this.credential}`,
-					"Content-Type": "application/json",
-					Accept: "application/json"
-				},
-				body: JSON.stringify({ apiKey })
-			});
-		} catch {
-			return { status: "unverifiable" };
-		}
-		if (response.status === 401) return { status: "invalid" };
-		if (!response.ok) return { status: "unverifiable" };
-		const body = await response.json().catch(() => null);
-		return body?.projectId ? {
-			status: "ok",
-			projectId: body.projectId
-		} : { status: "unverifiable" };
-	}
-};
-function initializeLogger(options) {
-	const colorize = options?.colorize ?? true;
-	const level = options?.level ?? process.env.LMNR_LOG_LEVEL?.toLowerCase()?.trim() ?? "info";
-	return pino({ level }, PinoPretty({
-		colorize,
-		minimumLevel: level
-	}));
-}
-const logger$4 = initializeLogger();
-const isStringUUID = (id) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(id);
-const newUUID = () => {
-	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
-	else return v4();
-};
-const otelSpanIdToUUID = (spanId) => {
-	let id = spanId.toLowerCase();
-	if (id.startsWith("0x")) id = id.slice(2);
-	if (id.length !== 16) logger$4.warn(`Span ID ${spanId} is not 16 hex chars long. This is not a valid OpenTelemetry span ID.`);
-	if (!/^[0-9a-f]+$/.test(id)) {
-		logger$4.error(`Span ID ${spanId} is not a valid hex string. Generating a random UUID instead.`);
-		return newUUID();
-	}
-	return id.padStart(32, "0").replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
-};
-const otelTraceIdToUUID = (traceId) => {
-	let id = traceId.toLowerCase();
-	if (id.startsWith("0x")) id = id.slice(2);
-	if (id.length !== 32) logger$4.warn(`Trace ID ${traceId} is not 32 hex chars long. This is not a valid OpenTelemetry trace ID.`);
-	if (!/^[0-9a-f]+$/.test(id)) {
-		logger$4.error(`Trace ID ${traceId} is not a valid hex string. Generating a random UUID instead.`);
-		return newUUID();
-	}
-	return id.replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
-};
-const slicePayload = (value, length) => {
-	if (value === null || value === void 0) return value;
-	const str = JSON.stringify(value);
-	if (str.length <= length) return value;
-	return str.slice(0, length) + "...";
-};
-const loadEnv = (options) => {
-	const nodeEnv = process.env.NODE_ENV || "development";
-	const envDir = process.cwd();
-	const envFiles = [
-		".env",
-		".env.local",
-		`.env.${nodeEnv}`,
-		`.env.${nodeEnv}.local`
-	];
-	const logLevel = process.env.LMNR_LOG_LEVEL ?? "info";
-	const verbose = ["debug", "trace"].includes(logLevel.trim().toLowerCase());
-	const quiet = options?.quiet ?? !verbose;
-	config({
-		path: options?.paths ?? envFiles.map((envFile) => path.resolve(envDir, envFile)),
-		quiet
-	});
-};
-const logger$3 = initializeLogger();
-const DEFAULT_DATASET_PULL_LIMIT = 100;
-const DEFAULT_DATASET_PUSH_BATCH_SIZE = 100;
-var DatasetsResource = class extends BaseResource {
-	constructor(baseHttpUrl, auth) {
-		super(baseHttpUrl, auth);
-	}
-	/**
-	* List all datasets.
-	*
-	* @returns {Promise<Dataset[]>} Array of datasets
-	*/
-	async listDatasets() {
-		const response = await fetch(this.baseHttpUrl + this.apiPrefix + "/datasets", {
-			method: "GET",
-			headers: this.headers()
-		});
-		if (!response.ok) await this.handleError(response);
-		return response.json();
-	}
-	/**
-	* Get a dataset by name.
-	*
-	* @param {string} name - Name of the dataset
-	* @returns {Promise<Dataset[]>} Array of datasets with matching name
-	*/
-	async getDatasetByName(name) {
-		const params = new URLSearchParams({ name });
-		const response = await fetch(this.baseHttpUrl + `${this.apiPrefix}/datasets?${params.toString()}`, {
-			method: "GET",
-			headers: this.headers()
-		});
-		if (!response.ok) await this.handleError(response);
-		return response.json();
+	/**
+	* Get a dataset by name.
+	*
+	* @param {string} name - Name of the dataset
+	* @returns {Promise<Dataset[]>} Array of datasets with matching name
+	*/
+	async getDatasetByName(name) {
+		const params = new URLSearchParams({ name });
+		const response = await fetch(this.baseHttpUrl + `${this.apiPrefix}/datasets?${params.toString()}`, {
+			method: "GET",
+			headers: this.headers()
+		});
+		if (!response.ok) await this.handleError(response);
+		return response.json();
 	}
 	/**
 	* Push datapoints to a dataset.
@@ -643,7 +307,7 @@ var DatasetsResource = class extends BaseResource {
 		return response.json();
 	}
 };
-const logger$2 = initializeLogger();
+const logger$2 = initializeLogger$1();
 const INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH = 16e6;
 var EvalsResource = class extends BaseResource {
 	constructor(baseHttpUrl, auth) {
@@ -723,14 +387,14 @@ var EvalsResource = class extends BaseResource {
 	* @returns {Promise<StringUUID>} The datapoint ID
 	*/
 	async createDatapoint({ evalId, data, target, metadata, index, traceId }) {
-		const datapointId = newUUID();
+		const datapointId = newUUID$1();
 		const partialDatapoint = {
 			id: datapointId,
 			data,
 			target,
 			index: index ?? 0,
-			traceId: traceId ?? newUUID(),
-			executorSpanId: newUUID(),
+			traceId: traceId ?? newUUID$1(),
+			executorSpanId: newUUID$1(),
 			metadata
 		};
 		await this.saveDatapoints({
@@ -882,14 +546,14 @@ var EvaluatorsResource = class extends BaseResource {
 			metadata,
 			score,
 			source: "Code",
-			traceId: isStringUUID(options.traceId) ? options.traceId : otelTraceIdToUUID(options.traceId)
+			traceId: isStringUUID$1(options.traceId) ? options.traceId : otelTraceIdToUUID$1(options.traceId)
 		};
 		else if ("spanId" in options && options.spanId) payload = {
 			name,
 			metadata,
 			score,
 			source: "Code",
-			spanId: isStringUUID(options.spanId) ? options.spanId : otelSpanIdToUUID(options.spanId)
+			spanId: isStringUUID$1(options.spanId) ? options.spanId : otelSpanIdToUUID$1(options.spanId)
 		};
 		else throw new Error("Either 'traceId' or 'spanId' must be provided.");
 		const response = await fetch(this.baseHttpUrl + "/v1/evaluators/score", {
@@ -900,7 +564,7 @@ var EvaluatorsResource = class extends BaseResource {
 		if (!response.ok) await this.handleError(response);
 	}
 };
-const logger$1 = initializeLogger();
+const logger$1 = initializeLogger$1();
 /**
 * Map the opaque HIT `response` payload onto a {@link CachedSpan} the provider
 * wrappers can replay. The server-side shape of `response` is not yet frozen
@@ -1230,11 +894,11 @@ var TagsResource = class extends BaseResource {
 	*/
 	async tag(trace_id, tags) {
 		const traceTags = Array.isArray(tags) ? tags : [tags];
-		const formattedTraceId = isStringUUID(trace_id) ? trace_id : otelTraceIdToUUID(trace_id);
+		const formattedTraceId = isStringUUID$1(trace_id) ? trace_id : otelTraceIdToUUID$1(trace_id);
 		const url = this.baseHttpUrl + "/v1/tag";
 		const payload = {
-			"traceId": formattedTraceId,
-			"names": traceTags
+			traceId: formattedTraceId,
+			names: traceTags
 		};
 		const response = await fetch(url, {
 			method: "POST",
@@ -1246,7 +910,7 @@ var TagsResource = class extends BaseResource {
 	}
 };
 /** Resource for post-factum operations on existing traces. */
-const logger = initializeLogger();
+const logger$5 = initializeLogger$1();
 var TracesResource = class extends BaseResource {
 	/** Resource for post-factum operations on existing traces. */
 	constructor(baseHttpUrl, auth) {
@@ -1304,7 +968,7 @@ var TracesResource = class extends BaseResource {
 	*/
 	async pushMetadata(traceId, metadata, options) {
 		if (!metadata || Object.keys(metadata).length === 0) throw new Error("metadata must be a non-empty object");
-		const formattedTraceId = isStringUUID(traceId) ? traceId : otelTraceIdToUUID(traceId);
+		const formattedTraceId = isStringUUID$1(traceId) ? traceId : otelTraceIdToUUID$1(traceId);
 		const url = this.baseHttpUrl + this.apiPrefix + "/traces/metadata";
 		const response = await fetch(url, {
 			method: "POST",
@@ -1317,7 +981,7 @@ var TracesResource = class extends BaseResource {
 		if (response.status === 404) {
 			const message = `Trace ${formattedTraceId} not found. The trace may not have been flushed yet — call await Laminar.flush() and retry.`;
 			if (options?.failOnNotFound) throw new Error(message);
-			logger.warn(message);
+			logger$5.warn(message);
 			return;
 		}
 		if (!response.ok) await this.handleError(response);
@@ -1325,7 +989,7 @@ var TracesResource = class extends BaseResource {
 };
 var LaminarClient = class LaminarClient {
 	constructor({ baseUrl, port, auth, projectApiKey, cliUserProjectId } = {}) {
-		loadEnv();
+		loadEnv$1();
 		this.auth = LaminarClient.normalizeAuth(auth, projectApiKey, cliUserProjectId);
 		const resolvedBaseUrl = baseUrl ?? process.env.LMNR_BASE_URL;
 		this.configuredUrl = resolvedBaseUrl;
@@ -1395,35 +1059,371 @@ var LaminarClient = class LaminarClient {
 	get browserEvents() {
 		return this._browserEvents;
 	}
-	get cli() {
-		return this._cli;
+	get cli() {
+		return this._cli;
+	}
+	get datasets() {
+		return this._datasets;
+	}
+	get evals() {
+		return this._evals;
+	}
+	get evaluators() {
+		return this._evaluators;
+	}
+	get signals() {
+		return this._signals;
+	}
+	get rolloutSessions() {
+		return this._rolloutSessions;
+	}
+	get sql() {
+		return this._sql;
+	}
+	get tags() {
+		return this._tags;
+	}
+	get traces() {
+		return this._traces;
+	}
+};
+//#endregion
+//#region package.json
+var version = "0.8.45";
+//#endregion
+//#region src/opentelemetry-lib/tracing/attributes.ts
+const SPAN_INPUT = "lmnr.span.input";
+const SPAN_OUTPUT = "lmnr.span.output";
+const SPAN_TYPE = "lmnr.span.type";
+const SPAN_PATH = "lmnr.span.path";
+const SPAN_IDS_PATH = "lmnr.span.ids_path";
+const PARENT_SPAN_PATH = "lmnr.span.parent_path";
+const PARENT_SPAN_IDS_PATH = "lmnr.span.parent_ids_path";
+const SPAN_INSTRUMENTATION_SOURCE = "lmnr.span.instrumentation_source";
+const SPAN_SDK_VERSION = "lmnr.span.sdk_version";
+const SPAN_LANGUAGE_VERSION = "lmnr.span.language_version";
+const SPAN_INSTRUMENTATION_SCOPE_NAME = "lmnr.span.instrumentation_scope.name";
+const SPAN_INSTRUMENTATION_SCOPE_VERSION = "lmnr.span.instrumentation_scope.version";
+const TRACE_HAS_BROWSER_SESSION = "lmnr.internal.has_browser_session";
+const HUMAN_EVALUATOR_OPTIONS = "lmnr.span.human_evaluator_options";
+const ASSOCIATION_PROPERTIES = "lmnr.association.properties";
+const SESSION_ID = "lmnr.association.properties.session_id";
+const USER_ID = "lmnr.association.properties.user_id";
+const TRACE_TYPE = "lmnr.association.properties.trace_type";
+const ASSOCIATION_PROPERTIES_OVERRIDES = { span_type: SPAN_TYPE };
+const LaminarAttributes = {
+	INPUT_TOKEN_COUNT: "gen_ai.usage.input_tokens",
+	OUTPUT_TOKEN_COUNT: "gen_ai.usage.output_tokens",
+	TOTAL_TOKEN_COUNT: "llm.usage.total_tokens",
+	PROVIDER: "gen_ai.system",
+	REQUEST_MODEL: "gen_ai.request.model",
+	RESPONSE_MODEL: "gen_ai.response.model",
+	INPUT_COST: "gen_ai.usage.input_cost",
+	OUTPUT_COST: "gen_ai.usage.output_cost",
+	TOTAL_COST: "gen_ai.usage.cost"
+};
+//#endregion
+//#region src/utils.ts
+function initializeLogger(options) {
+	const colorize = options?.colorize ?? true;
+	const level = options?.level ?? process.env.LMNR_LOG_LEVEL?.toLowerCase()?.trim() ?? "info";
+	return pino({ level }, PinoPretty({
+		colorize,
+		minimumLevel: level
+	}));
+}
+const logger = initializeLogger();
+const isStringUUID = (id) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(id);
+const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+const newUUID = () => {
+	if (typeof crypto !== "undefined" && typeof crypto.randomUUID === "function") return crypto.randomUUID();
+	else return v4();
+};
+const normalizeOtelTraceId = (traceId) => {
+	let id = traceId.toLowerCase();
+	if (id.startsWith("0x")) id = id.slice(2);
+	return id.padStart(32, "0").slice(-32);
+};
+const normalizeOtelSpanId = (spanId) => {
+	let id = spanId.toLowerCase();
+	if (id.startsWith("0x")) id = id.slice(2);
+	return id.padStart(16, "0").slice(-16);
+};
+const otelSpanIdToUUID = (spanId) => {
+	let id = spanId.toLowerCase();
+	if (id.startsWith("0x")) id = id.slice(2);
+	if (id.length !== 16) logger.warn(`Span ID ${spanId} is not 16 hex chars long. This is not a valid OpenTelemetry span ID.`);
+	if (!/^[0-9a-f]+$/.test(id)) {
+		logger.error(`Span ID ${spanId} is not a valid hex string. Generating a random UUID instead.`);
+		return newUUID();
+	}
+	return id.padStart(32, "0").replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
+};
+const otelTraceIdToUUID = (traceId) => {
+	let id = traceId.toLowerCase();
+	if (id.startsWith("0x")) id = id.slice(2);
+	if (id.length !== 32) logger.warn(`Trace ID ${traceId} is not 32 hex chars long. This is not a valid OpenTelemetry trace ID.`);
+	if (!/^[0-9a-f]+$/.test(id)) {
+		logger.error(`Trace ID ${traceId} is not a valid hex string. Generating a random UUID instead.`);
+		return newUUID();
+	}
+	return id.replace(/^([0-9a-f]{8})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{4})([0-9a-f]{12})$/, "$1-$2-$3-$4-$5");
+};
+const uuidToOtelTraceId = (uuid) => uuid.replace(/-/g, "");
+const uuidToOtelSpanId = (uuid) => uuid.replace(/-/g, "").slice(16);
+/**
+* This is a simple implementation of a semaphore to replicate
+* the behavior of the `asyncio.Semaphore` in Python.
+*/
+var Semaphore = class {
+	constructor(value = 1) {
+		this._waiters = [];
+		if (value < 0) throw new Error("Semaphore value must be >= 0");
+		this._value = value;
+		this._waiters = [];
+	}
+	async acquire() {
+		if (this._value > 0) {
+			this._value--;
+			return;
+		}
+		return new Promise((resolve) => {
+			this._waiters.push(resolve);
+		});
 	}
-	get datasets() {
-		return this._datasets;
+	release() {
+		if (this._waiters.length > 0) this._waiters.shift()?.();
+		else this._value++;
 	}
-	get evals() {
-		return this._evals;
+	async using(fn) {
+		try {
+			await this.acquire();
+			return await fn();
+		} finally {
+			this.release();
+		}
 	}
-	get evaluators() {
-		return this._evaluators;
+};
+const tryToOtelSpanContext = (spanContext) => {
+	if (typeof spanContext === "string") try {
+		return recordToOtelSpanContext(JSON.parse(spanContext));
+	} catch (e) {
+		throw new Error(`Failed to parse span context ${spanContext}. The string must be a json representation of a LaminarSpanContext.Error: ${errorMessage(e)}`);
 	}
-	get signals() {
-		return this._signals;
+	else if (isRecord(spanContext)) return recordToOtelSpanContext(spanContext);
+	else if (typeof spanContext.traceId === "string" && typeof spanContext.spanId === "string" && spanContext.traceId.length === 32 && spanContext.spanId.length === 16) {
+		logger.warn("The span context is already an OpenTelemetry SpanContext. Returning it as is. Please use `LaminarSpanContext` objects instead.");
+		return spanContext;
+	} else throw new Error(`Invalid span context ${JSON.stringify(spanContext)}. Must be a LaminarSpanContext or its json representation.`);
+};
+const recordToOtelSpanContext = (record) => {
+	if (typeof record.spanId === "string" && typeof record.traceId === "string" || typeof record.span_id === "string" && typeof record.trace_id === "string") return {
+		spanId: uuidToOtelSpanId(record?.spanId ?? record?.["span_id"]),
+		traceId: uuidToOtelTraceId(record?.traceId ?? record?.["trace_id"]),
+		isRemote: record?.isRemote ?? record?.["is_remote"] ?? false,
+		traceFlags: record?.traceFlags ?? TraceFlags.SAMPLED
+	};
+	else throw new Error(`Invalid span context ${JSON.stringify(record)}. Must be a json representation of a LaminarSpanContext.`);
+};
+const isRecord = (value) => typeof value === "object" && !Array.isArray(value) && value !== null;
+/**
+* Deserialize a LaminarSpanContext from a string or record.
+* Handles both camelCase and snake_case keys for cross-language compatibility.
+*
+* @param data - The data to deserialize (string or record)
+* @returns The deserialized LaminarSpanContext
+* @throws Error if the data is invalid
+*/
+const deserializeLaminarSpanContext = (data) => {
+	if (typeof data === "string") try {
+		return deserializeLaminarSpanContext(JSON.parse(data));
+	} catch (e) {
+		throw new Error(`Failed to parse LaminarSpanContext: ${errorMessage(e)}`);
 	}
-	get rolloutSessions() {
-		return this._rolloutSessions;
+	if (!isRecord(data)) throw new Error("Invalid LaminarSpanContext: must be a string or object");
+	const traceId = data.traceId ?? data.trace_id;
+	const spanId = data.spanId ?? data.span_id;
+	const isRemote = data.isRemote ?? data.is_remote ?? false;
+	const spanPath = data.spanPath ?? data.span_path;
+	const spanIdsPath = data.spanIdsPath ?? data.span_ids_path;
+	const userId = data.userId ?? data.user_id;
+	const sessionId = data.sessionId ?? data.session_id;
+	const metadata = data.metadata;
+	const traceType = data.traceType ?? data.trace_type;
+	const tracingLevel = data.tracingLevel ?? data.tracing_level;
+	const debug = data.debug;
+	if (typeof traceId !== "string" || typeof spanId !== "string") throw new Error("Invalid LaminarSpanContext: traceId and spanId must be strings");
+	if (!isStringUUID(traceId) || !isStringUUID(spanId)) throw new Error("Invalid LaminarSpanContext: traceId and spanId must be valid UUIDs");
+	return {
+		traceId,
+		spanId,
+		isRemote: Boolean(isRemote),
+		spanPath: Array.isArray(spanPath) ? spanPath : void 0,
+		spanIdsPath: Array.isArray(spanIdsPath) ? spanIdsPath : void 0,
+		userId,
+		sessionId,
+		metadata,
+		traceType,
+		tracingLevel,
+		debug: isRecord(debug) ? deserializeDebugContext(debug) : void 0
+	};
+};
+/**
+* Normalize a value to a canonical lowercase UUID string, or undefined.
+*
+* The debug block's `sessionId` / `replayTraceId` are always full ids; a value
+* that isn't UUID-shaped is dropped (treated as absent) rather than thrown, so
+* a partially-broken block never breaks span-context parsing.
+*/
+const asString = (value) => typeof value === "string" && value.length > 0 ? value : void 0;
+/**
+* Parse a debug block, accepting camelCase and snake_case. All ids are kept
+* VERBATIM: the producer emits the run's exact session / replay-trace /
+* cache-until strings (un-normalized — `LMNR_DEBUG_SESSION_ID` may be an
+* arbitrary non-UUID value), so the consumer must round-trip them unchanged or
+* a downstream run never joins the run. Keep line-comparable with the Python
+* `DebugContext.deserialize`.
+*/
+const deserializeDebugContext = (data) => ({
+	enabled: data.enabled === true,
+	sessionId: asString(data.sessionId ?? data.session_id),
+	replayTraceId: asString(data.replayTraceId ?? data.replay_trace_id),
+	cacheUntil: asString(data.cacheUntil ?? data.cache_until)
+});
+const getDirname = () => {
+	if (typeof __dirname !== "undefined") return __dirname;
+	if (typeof import.meta.url !== "undefined") return path.dirname(fileURLToPath(import.meta.url));
+	return process.cwd();
+};
+const MAX_MANUAL_SPAN_PAYLOAD_SIZE = 1024 * 1024 * 10;
+const TRUNCATION_SUFFIX = "...[Laminar: truncated]";
+/**
+* Cut an oversized span payload down to the limit rather than dropping it.
+*
+* Keeping the leading bytes preserves the start of the value, which is the useful part when
+* debugging. Mirrors `_truncate_payload` in the Python SDK.
+*
+* Callers pass the result of `JSON.stringify`, whose TS signature claims `string` but which
+* actually returns `undefined` for a top-level `undefined`, function, or symbol. Guard at
+* runtime and hand such values straight back: `setAttribute` treats them as a no-op, which is
+* the behaviour these payloads had before truncation existed.
+*/
+const truncateSpanPayload = (serialized, kind) => {
+	if (typeof serialized !== "string") return serialized;
+	if (serialized.length <= 10485760) return serialized;
+	logger.warn(`Laminar: span ${kind} is ${serialized.length} bytes, which exceeds the ${MAX_MANUAL_SPAN_PAYLOAD_SIZE} byte limit. Truncating to the limit; the recorded value will not be valid JSON.`);
+	const keep = MAX_MANUAL_SPAN_PAYLOAD_SIZE - 23;
+	return serialized.slice(0, keep) + TRUNCATION_SUFFIX;
+};
+const isOtelAttributeValueType = (value) => {
+	if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") return true;
+	if (Array.isArray(value)) {
+		const allStrings = value.every((value) => value == null || typeof value === "string");
+		const allNumbers = value.every((value) => value == null || typeof value === "number");
+		const allBooleans = value.every((value) => value == null || typeof value === "boolean");
+		return allStrings || allNumbers || allBooleans;
 	}
-	get sql() {
-		return this._sql;
+	return false;
+};
+const metadataToAttributes = (metadata) => Object.fromEntries(Object.entries(metadata).map(([key, value]) => {
+	if (isOtelAttributeValueType(value)) return [`${ASSOCIATION_PROPERTIES}.metadata.${key}`, value];
+	else return [`${ASSOCIATION_PROPERTIES}.metadata.${key}`, JSON.stringify(value)];
+}));
+/**
+* Get OTEL environment variable with priority order.
+* Checks in order:
+* 1. OTEL_EXPORTER_OTLP_TRACES_{varName}
+* 2. OTEL_EXPORTER_OTLP_{varName}
+* 3. OTEL_{varName}
+*
+* @param varName - The variable name (e.g., 'ENDPOINT', 'HEADERS', 'PROTOCOL')
+* @returns The environment variable value or undefined if not found
+*/
+const getOtelEnvVar = (varName) => {
+	const candidates = [
+		`OTEL_EXPORTER_OTLP_TRACES_${varName}`,
+		`OTEL_EXPORTER_OTLP_${varName}`,
+		`OTEL_${varName}`
+	];
+	for (const candidate of candidates) {
+		const value = process?.env?.[candidate];
+		if (value) return value;
 	}
-	get tags() {
-		return this._tags;
+};
+/**
+* Check if OTEL configuration is available.
+* @returns true if OTEL endpoint is configured
+*/
+const hasOtelConfig = () => !!getOtelEnvVar("ENDPOINT");
+/**
+* Parse OTEL headers string into a record object.
+* Format: key1=value1,key2=value2
+* Values are URL-decoded.
+*
+* @param headersStr - Headers string in OTEL format
+* @returns Parsed headers object
+*/
+const parseOtelHeaders = (headersStr) => {
+	if (!headersStr) return {};
+	const headers = {};
+	for (const pair of headersStr.split(",")) {
+		const equalIndex = pair.indexOf("=");
+		if (equalIndex !== -1) {
+			const key = pair.substring(0, equalIndex).trim();
+			const value = pair.substring(equalIndex + 1).trim();
+			headers[key] = decodeURIComponent(value);
+		}
 	}
-	get traces() {
-		return this._traces;
+	return headers;
+};
+/**
+* Validate that either Laminar API key or OTEL configuration is present.
+* Throws an error if neither is configured.
+*
+* @param apiKey - The Laminar API key (if provided)
+* @throws Error if neither API key nor OTEL configuration is present
+*/
+const validateTracingConfig = (apiKey) => {
+	if (!apiKey && !hasOtelConfig()) throw new Error("Please initialize the Laminar object with your project API key or set the LMNR_PROJECT_API_KEY environment variable, or configure OTEL environment variables (OTEL_EXPORTER_OTLP_TRACES_ENDPOINT, etc.)");
+};
+const loadEnv = (options) => {
+	const nodeEnv = process.env.NODE_ENV || "development";
+	const envDir = process.cwd();
+	const envFiles = [
+		".env",
+		".env.local",
+		`.env.${nodeEnv}`,
+		`.env.${nodeEnv}.local`
+	];
+	const logLevel = process.env.LMNR_LOG_LEVEL ?? "info";
+	const verbose = ["debug", "trace"].includes(logLevel.trim().toLowerCase());
+	const quiet = options?.quiet ?? !verbose;
+	config({
+		path: options?.paths ?? envFiles.map((envFile) => path.resolve(envDir, envFile)),
+		quiet
+	});
+};
+/**
+* Converts an API base URL to the frontend/web URL.
+* - Converts https://api.lmnr.ai to https://www.laminar.sh
+* - Removes trailing slashes
+* - For localhost/127.0.0.1, ensures a port is specified (defaults to 5667)
+*
+* @param baseUrl - The API base URL (defaults to "https://api.lmnr.ai")
+* @returns The frontend URL
+*/
+const getFrontendUrl = (baseUrl, frontendPort) => {
+	let url = baseUrl ?? "https://api.lmnr.ai";
+	if (url === "https://api.lmnr.ai") url = "https://www.laminar.sh";
+	url = url.replace(/\/$/, "");
+	if (/localhost|127\.0\.0\.1/.test(url)) {
+		const port = frontendPort ?? url.match(/:\d{1,5}$/g)?.[0]?.slice(1) ?? 5667;
+		if (/:(\d{1,5})$/.test(url)) url = url.replace(/:\d{1,5}$/g, `:${port}`);
+		else url = `${url}:${port}`;
 	}
+	return url;
 };
 //#endregion
-export { SPAN_INSTRUMENTATION_SCOPE_VERSION as A, version$1 as B, LaminarAttributes as C, SPAN_IDS_PATH as D, SESSION_ID as E, SPAN_SDK_VERSION as F, DEBUG_SESSION_FILE as H, SPAN_TYPE as I, TRACE_HAS_BROWSER_SESSION as L, SPAN_LANGUAGE_VERSION as M, SPAN_OUTPUT as N, SPAN_INPUT as O, SPAN_PATH as P, TRACE_TYPE as R, HUMAN_EVALUATOR_OPTIONS as S, PARENT_SPAN_PATH as T, TracingLevel as U, DEBUG_SESSION_DIR as V, errorMessage as W, truncateSpanPayload as _, getDirname as a, ASSOCIATION_PROPERTIES as b, initializeLogger$1 as c, newUUID$1 as d, normalizeOtelSpanId as f, parseOtelHeaders as g, otelTraceIdToUUID$1 as h, deserializeLaminarSpanContext as i, SPAN_INSTRUMENTATION_SOURCE as j, SPAN_INSTRUMENTATION_SCOPE_NAME as k, loadEnv$1 as l, otelSpanIdToUUID$1 as m, NIL_UUID as n, getFrontendUrl as o, normalizeOtelTraceId as p, Semaphore as r, getOtelEnvVar as s, LaminarClient as t, metadataToAttributes as u, tryToOtelSpanContext as v, PARENT_SPAN_IDS_PATH as w, ASSOCIATION_PROPERTIES_OVERRIDES as x, validateTracingConfig as y, USER_ID as z };
+export { SPAN_INSTRUMENTATION_SOURCE as A, LaminarClient as B, PARENT_SPAN_IDS_PATH as C, SPAN_INPUT as D, SPAN_IDS_PATH as E, SPAN_TYPE as F, DEBUG_SESSION_FILE as H, TRACE_HAS_BROWSER_SESSION as I, TRACE_TYPE as L, SPAN_OUTPUT as M, SPAN_PATH as N, SPAN_INSTRUMENTATION_SCOPE_NAME as O, SPAN_SDK_VERSION as P, USER_ID as R, LaminarAttributes as S, SESSION_ID as T, TracingLevel as U, DEBUG_SESSION_DIR as V, errorMessage as W, tryToOtelSpanContext as _, getFrontendUrl as a, ASSOCIATION_PROPERTIES_OVERRIDES as b, loadEnv as c, normalizeOtelSpanId as d, normalizeOtelTraceId as f, truncateSpanPayload as g, parseOtelHeaders as h, getDirname as i, SPAN_LANGUAGE_VERSION as j, SPAN_INSTRUMENTATION_SCOPE_VERSION as k, metadataToAttributes as l, otelTraceIdToUUID as m, Semaphore as n, getOtelEnvVar as o, otelSpanIdToUUID as p, deserializeLaminarSpanContext as r, initializeLogger as s, NIL_UUID as t, newUUID as u, validateTracingConfig as v, PARENT_SPAN_PATH as w, HUMAN_EVALUATOR_OPTIONS as x, ASSOCIATION_PROPERTIES as y, version as z };
 
-//# sourceMappingURL=dist-Cjres0a5.mjs.map
+//# sourceMappingURL=utils-UmlDPMxe.mjs.map