@lmnr-ai/lmnr 0.8.28 → 0.8.30

package/dist/{dist-K0otr9Ia.mjs → dist-DMgpr2Zn.mjs}

@@ -5,25 +5,31 @@ import pino from "pino";
 import { PinoPretty } from "pino-pretty";
 import { v4 } from "uuid";
 //#region package.json
-var version$1 = "0.8.28";
+var version$1 = "0.8.30";
 //#endregion
 //#region ../client/dist/index.mjs
-var version = "0.8.28";
+var version = "0.8.30";
 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, projectApiKey) {
+	constructor(baseHttpUrl, auth) {
 		this.baseHttpUrl = baseHttpUrl;
-		this.projectApiKey = projectApiKey;
+		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.projectApiKey}`,
+			Authorization: `Bearer ${this.credential}`,
 			"Content-Type": "application/json",
-			Accept: "application/json"
+			Accept: "application/json",
+			...this.auth.type === "userToken" ? { "x-lmnr-project-id": this.auth.projectId } : {}
 		};
 	}
 	async handleError(response) {
@@ -32,8 +38,8 @@ var BaseResource = class {
 	}
 };
 var BrowserEventsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	async send({ sessionId, traceId, events }) {
 		const payload = {
@@ -57,6 +63,33 @@ var BrowserEventsResource = class extends BaseResource {
 		if (!response.ok) await this.handleError(response);
 	}
 };
+/**
+* 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) ? body.projects : [];
+	}
+};
 function initializeLogger(options) {
 	const colorize = options?.colorize ?? true;
 	const level = options?.level ?? process.env.LMNR_LOG_LEVEL?.toLowerCase()?.trim() ?? "info";
@@ -118,8 +151,8 @@ const logger$3 = initializeLogger();
 const DEFAULT_DATASET_PULL_LIMIT = 100;
 const DEFAULT_DATASET_PUSH_BATCH_SIZE = 100;
 var DatasetsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* List all datasets.
@@ -127,7 +160,7 @@ var DatasetsResource = class extends BaseResource {
 	* @returns {Promise<Dataset[]>} Array of datasets
 	*/
 	async listDatasets() {
-		const response = await fetch(this.baseHttpUrl + "/v1/datasets", {
+		const response = await fetch(this.baseHttpUrl + this.apiPrefix + "/datasets", {
 			method: "GET",
 			headers: this.headers()
 		});
@@ -142,7 +175,7 @@ var DatasetsResource = class extends BaseResource {
 	*/
 	async getDatasetByName(name) {
 		const params = new URLSearchParams({ name });
-		const response = await fetch(this.baseHttpUrl + `/v1/datasets?${params.toString()}`, {
+		const response = await fetch(this.baseHttpUrl + `${this.apiPrefix}/datasets?${params.toString()}`, {
 			method: "GET",
 			headers: this.headers()
 		});
@@ -171,7 +204,7 @@ var DatasetsResource = class extends BaseResource {
 			const batchNum = Math.floor(i / batchSize) + 1;
 			logger$3.debug(`Pushing batch ${batchNum} of ${totalBatches}`);
 			const batch = points.slice(i, i + batchSize);
-			const fetchResponse = await fetch(this.baseHttpUrl + "/v1/datasets/datapoints", {
+			const fetchResponse = await fetch(this.baseHttpUrl + this.apiPrefix + "/datasets/datapoints", {
 				method: "POST",
 				headers: this.headers(),
 				body: JSON.stringify({
@@ -209,7 +242,7 @@ var DatasetsResource = class extends BaseResource {
 		if (name) paramsObj.name = name;
 		else paramsObj.datasetId = id;
 		const params = new URLSearchParams(paramsObj);
-		const response = await fetch(this.baseHttpUrl + `/v1/datasets/datapoints?${params.toString()}`, {
+		const response = await fetch(this.baseHttpUrl + `${this.apiPrefix}/datasets/datapoints?${params.toString()}`, {
 			method: "GET",
 			headers: this.headers()
 		});
@@ -220,8 +253,8 @@ var DatasetsResource = class extends BaseResource {
 const logger$2 = initializeLogger();
 const INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH = 16e6;
 var EvalsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Initialize an evaluation.
@@ -395,8 +428,8 @@ var EvalsResource = class extends BaseResource {
 * Resource for creating evaluator scores
 */
 var EvaluatorsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Create a score for a span or trace
@@ -474,8 +507,8 @@ const toCachedSpan = (response) => {
 	};
 };
 var RolloutSessionsResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Idempotently register (upsert) a debug session on the backend, keyed on the
@@ -486,7 +519,7 @@ var RolloutSessionsResource = class extends BaseResource {
 	* caller can build the debugger URL; null if the body can't be parsed.
 	*/
 	async register({ sessionId, name }) {
-		const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}`, {
 			method: "POST",
 			headers: this.headers(),
 			body: JSON.stringify({ name })
@@ -506,7 +539,7 @@ var RolloutSessionsResource = class extends BaseResource {
 	* stays the SDK's job via {@link register}.
 	*/
 	async setName({ sessionId, name }) {
-		const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/name`, {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}/name`, {
 			method: "PATCH",
 			headers: this.headers(),
 			body: JSON.stringify({ name })
@@ -530,7 +563,7 @@ var RolloutSessionsResource = class extends BaseResource {
 	async cache({ sessionId, replayTraceId, cacheUntil, inputHash }) {
 		let response;
 		try {
-			response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}/cache`, {
+			response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}/cache`, {
 				method: "POST",
 				headers: this.headers(),
 				body: JSON.stringify({
@@ -572,7 +605,7 @@ var RolloutSessionsResource = class extends BaseResource {
 		}
 	}
 	async delete({ sessionId }) {
-		const response = await fetch(`${this.baseHttpUrl}/v1/rollouts/${sessionId}`, {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}`, {
 			method: "DELETE",
 			headers: this.headers()
 		});
@@ -580,11 +613,11 @@ var RolloutSessionsResource = class extends BaseResource {
 	}
 };
 var SqlResource = class extends BaseResource {
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	async query(sql, parameters = {}) {
-		const response = await fetch(`${this.baseHttpUrl}/v1/sql/query`, {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/sql/query`, {
 			method: "POST",
 			headers: { ...this.headers() },
 			body: JSON.stringify({
@@ -599,8 +632,8 @@ var SqlResource = class extends BaseResource {
 /** Resource for tagging traces. */
 var TagsResource = class extends BaseResource {
 	/** Resource for tagging traces. */
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Tag a trace with a list of tags. Note that the trace must be ended before
@@ -655,8 +688,8 @@ var TagsResource = class extends BaseResource {
 const logger = initializeLogger();
 var TracesResource = class extends BaseResource {
 	/** Resource for post-factum operations on existing traces. */
-	constructor(baseHttpUrl, projectApiKey) {
-		super(baseHttpUrl, projectApiKey);
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
 	}
 	/**
 	* Push a metadata patch to an existing trace.
@@ -711,7 +744,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 url = this.baseHttpUrl + "/v1/traces/metadata";
+		const url = this.baseHttpUrl + this.apiPrefix + "/traces/metadata";
 		const response = await fetch(url, {
 			method: "POST",
 			headers: this.headers(),
@@ -729,25 +762,49 @@ var TracesResource = class extends BaseResource {
 		if (!response.ok) await this.handleError(response);
 	}
 };
-var LaminarClient = class {
-	constructor({ baseUrl, projectApiKey, port } = {}) {
+var LaminarClient = class LaminarClient {
+	constructor({ baseUrl, port, auth, projectApiKey, cliUserProjectId } = {}) {
 		loadEnv();
-		this.projectApiKey = projectApiKey ?? process.env.LMNR_PROJECT_API_KEY;
+		this.auth = LaminarClient.normalizeAuth(auth, projectApiKey, cliUserProjectId);
 		const httpPort = port ?? (baseUrl?.match(/:\d{1,5}$/g) ? parseInt(baseUrl.match(/:\d{1,5}$/g)[0].slice(1)) : 443);
 		const baseUrlNoPort = (baseUrl ?? process.env.LMNR_BASE_URL)?.replace(/\/$/, "").replace(/:\d{1,5}$/g, "");
 		this.baseUrl = `${baseUrlNoPort ?? "https://api.lmnr.ai"}:${httpPort}`;
-		this._browserEvents = new BrowserEventsResource(this.baseUrl, this.projectApiKey);
-		this._datasets = new DatasetsResource(this.baseUrl, this.projectApiKey);
-		this._evals = new EvalsResource(this.baseUrl, this.projectApiKey);
-		this._evaluators = new EvaluatorsResource(this.baseUrl, this.projectApiKey);
-		this._rolloutSessions = new RolloutSessionsResource(this.baseUrl, this.projectApiKey);
-		this._sql = new SqlResource(this.baseUrl, this.projectApiKey);
-		this._tags = new TagsResource(this.baseUrl, this.projectApiKey);
-		this._traces = new TracesResource(this.baseUrl, this.projectApiKey);
+		this._browserEvents = new BrowserEventsResource(this.baseUrl, this.auth);
+		this._cli = new CliResource(this.baseUrl, this.auth);
+		this._datasets = new DatasetsResource(this.baseUrl, this.auth);
+		this._evals = new EvalsResource(this.baseUrl, this.auth);
+		this._evaluators = new EvaluatorsResource(this.baseUrl, this.auth);
+		this._rolloutSessions = new RolloutSessionsResource(this.baseUrl, this.auth);
+		this._sql = new SqlResource(this.baseUrl, this.auth);
+		this._tags = new TagsResource(this.baseUrl, this.auth);
+		this._traces = new TracesResource(this.baseUrl, this.auth);
+	}
+	/**
+	* Normalize the constructor's auth inputs into a {@link LaminarAuth} union.
+	* Precedence: an explicit `auth` wins; otherwise the legacy
+	* `projectApiKey` (+ optional `cliUserProjectId`) is mapped — a present
+	* `cliUserProjectId` selects the user-token surface, otherwise the project
+	* key surface. Falls back to `LMNR_PROJECT_API_KEY` as a project key.
+	*/
+	static normalizeAuth(auth, projectApiKey, cliUserProjectId) {
+		if (auth) return auth;
+		const key = projectApiKey ?? process.env.LMNR_PROJECT_API_KEY;
+		if (cliUserProjectId) return {
+			type: "userToken",
+			token: key,
+			projectId: cliUserProjectId
+		};
+		return {
+			type: "apiKey",
+			key
+		};
 	}
 	get browserEvents() {
 		return this._browserEvents;
 	}
+	get cli() {
+		return this._cli;
+	}
 	get datasets() {
 		return this._datasets;
 	}
@@ -773,4 +830,4 @@ var LaminarClient = class {
 //#endregion
 export { version$1 as n, LaminarClient as t };
 
-//# sourceMappingURL=dist-K0otr9Ia.mjs.map
+//# sourceMappingURL=dist-DMgpr2Zn.mjs.map

package/dist/dist-DMgpr2Zn.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"dist-DMgpr2Zn.mjs","names":[],"sources":["../package.json","../../client/dist/index.mjs"],"sourcesContent":["","import { config } from \"dotenv\";\nimport * as path from \"path\";\nimport pino from \"pino\";\nimport { PinoPretty } from \"pino-pretty\";\nimport { v4 } from \"uuid\";\nimport { errorMessage } from \"@lmnr-ai/types\";\n//#region package.json\nvar version = \"0.8.30\";\n//#endregion\n//#region src/version.ts\nfunction getLangVersion() {\n\tif (typeof process !== \"undefined\" && process.versions && process.versions.node) return `node-${process.versions.node}`;\n\tif (typeof navigator !== \"undefined\" && navigator.userAgent) return `browser-${navigator.userAgent}`;\n\treturn null;\n}\n//#endregion\n//#region src/resources/index.ts\nvar BaseResource = class {\n\tconstructor(baseHttpUrl, auth) {\n\t\tthis.baseHttpUrl = baseHttpUrl;\n\t\tthis.auth = auth;\n\t\tthis.credential = auth.type === \"apiKey\" ? auth.key : auth.token;\n\t}\n\t/** API path prefix: `/v1/cli` for CLI user-token auth, `/v1` otherwise. */\n\tget apiPrefix() {\n\t\treturn this.auth.type === \"userToken\" ? \"/v1/cli\" : \"/v1\";\n\t}\n\theaders() {\n\t\treturn {\n\t\t\tAuthorization: `Bearer ${this.credential}`,\n\t\t\t\"Content-Type\": \"application/json\",\n\t\t\tAccept: \"application/json\",\n\t\t\t...this.auth.type === \"userToken\" ? { \"x-lmnr-project-id\": this.auth.projectId } : {}\n\t\t};\n\t}\n\tasync handleError(response) {\n\t\tconst errorMsg = await response.text();\n\t\tthrow new Error(`${response.status} ${errorMsg}`);\n\t}\n};\n//#endregion\n//#region src/resources/browser-events.ts\nvar BrowserEventsResource = class extends BaseResource {\n\tconstructor(baseHttpUrl, auth) {\n\t\tsuper(baseHttpUrl, auth);\n\t}\n\tasync send({ sessionId, traceId, events }) {\n\t\tconst payload = {\n\t\t\tsessionId,\n\t\t\ttraceId,\n\t\t\tevents,\n\t\t\tsource: getLangVersion() ?? \"javascript\",\n\t\t\tsdkVersion: version\n\t\t};\n\t\tconst jsonString = JSON.stringify(payload);\n\t\tconst compressedStream = new Blob([jsonString], { type: \"application/json\" }).stream().pipeThrough(new CompressionStream(\"gzip\"));\n\t\tconst compressedData = await new Response(compressedStream).arrayBuffer();\n\t\tconst response = await fetch(this.baseHttpUrl + \"/v1/browser-sessions/events\", {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: {\n\t\t\t\t...this.headers(),\n\t\t\t\t\"Content-Encoding\": \"gzip\"\n\t\t\t},\n\t\t\tbody: compressedData\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t}\n};\n//#endregion\n//#region src/resources/cli.ts\n/**\n* User-scoped CLI endpoints that don't target a specific project. Authed by the\n* BetterAuth user JWT (the `credential`); deliberately does NOT send an\n* `x-lmnr-project-id` header (these routes are project discovery, pre-selection).\n*\n* Discovery exception: this resource always hits `/v1/cli/projects` with the\n* bare bearer and overrides `BaseResource.headers()`/`apiPrefix`, so it works\n* even when constructed with a `userToken` auth that has no real project id yet.\n*/\nvar CliResource = class extends BaseResource {\n\tconstructor(baseHttpUrl, auth) {\n\t\tsuper(baseHttpUrl, auth);\n\t}\n\t/** Workspaces + projects the authenticated user can access. */\n\tasync listProjects() {\n\t\tconst response = await fetch(`${this.baseHttpUrl}/v1/cli/projects`, {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: {\n\t\t\t\tAuthorization: `Bearer ${this.credential}`,\n\t\t\t\tAccept: \"application/json\"\n\t\t\t}\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t\tconst body = await response.json();\n\t\treturn Array.isArray(body?.projects) ? body.projects : [];\n\t}\n};\n//#endregion\n//#region src/utils.ts\nfunction initializeLogger(options) {\n\tconst colorize = options?.colorize ?? true;\n\tconst level = options?.level ?? process.env.LMNR_LOG_LEVEL?.toLowerCase()?.trim() ?? \"info\";\n\treturn pino({ level }, PinoPretty({\n\t\tcolorize,\n\t\tminimumLevel: level\n\t}));\n}\nconst logger$4 = initializeLogger();\nconst isStringUUID = (id) => /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(id);\nconst newUUID = () => {\n\tif (typeof crypto !== \"undefined\" && typeof crypto.randomUUID === \"function\") return crypto.randomUUID();\n\telse return v4();\n};\nconst otelSpanIdToUUID = (spanId) => {\n\tlet id = spanId.toLowerCase();\n\tif (id.startsWith(\"0x\")) id = id.slice(2);\n\tif (id.length !== 16) logger$4.warn(`Span ID ${spanId} is not 16 hex chars long. This is not a valid OpenTelemetry span ID.`);\n\tif (!/^[0-9a-f]+$/.test(id)) {\n\t\tlogger$4.error(`Span ID ${spanId} is not a valid hex string. Generating a random UUID instead.`);\n\t\treturn newUUID();\n\t}\n\treturn 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\");\n};\nconst otelTraceIdToUUID = (traceId) => {\n\tlet id = traceId.toLowerCase();\n\tif (id.startsWith(\"0x\")) id = id.slice(2);\n\tif (id.length !== 32) logger$4.warn(`Trace ID ${traceId} is not 32 hex chars long. This is not a valid OpenTelemetry trace ID.`);\n\tif (!/^[0-9a-f]+$/.test(id)) {\n\t\tlogger$4.error(`Trace ID ${traceId} is not a valid hex string. Generating a random UUID instead.`);\n\t\treturn newUUID();\n\t}\n\treturn 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\");\n};\nconst slicePayload = (value, length) => {\n\tif (value === null || value === void 0) return value;\n\tconst str = JSON.stringify(value);\n\tif (str.length <= length) return value;\n\treturn str.slice(0, length) + \"...\";\n};\nconst loadEnv = (options) => {\n\tconst nodeEnv = process.env.NODE_ENV || \"development\";\n\tconst envDir = process.cwd();\n\tconst envFiles = [\n\t\t\".env\",\n\t\t\".env.local\",\n\t\t`.env.${nodeEnv}`,\n\t\t`.env.${nodeEnv}.local`\n\t];\n\tconst logLevel = process.env.LMNR_LOG_LEVEL ?? \"info\";\n\tconst verbose = [\"debug\", \"trace\"].includes(logLevel.trim().toLowerCase());\n\tconst quiet = options?.quiet ?? !verbose;\n\tconfig({\n\t\tpath: options?.paths ?? envFiles.map((envFile) => path.resolve(envDir, envFile)),\n\t\tquiet\n\t});\n};\n//#endregion\n//#region src/resources/datasets.ts\nconst logger$3 = initializeLogger();\nconst DEFAULT_DATASET_PULL_LIMIT = 100;\nconst DEFAULT_DATASET_PUSH_BATCH_SIZE = 100;\nvar DatasetsResource = class extends BaseResource {\n\tconstructor(baseHttpUrl, auth) {\n\t\tsuper(baseHttpUrl, auth);\n\t}\n\t/**\n\t* List all datasets.\n\t*\n\t* @returns {Promise<Dataset[]>} Array of datasets\n\t*/\n\tasync listDatasets() {\n\t\tconst response = await fetch(this.baseHttpUrl + this.apiPrefix + \"/datasets\", {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: this.headers()\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t\treturn response.json();\n\t}\n\t/**\n\t* Get a dataset by name.\n\t*\n\t* @param {string} name - Name of the dataset\n\t* @returns {Promise<Dataset[]>} Array of datasets with matching name\n\t*/\n\tasync getDatasetByName(name) {\n\t\tconst params = new URLSearchParams({ name });\n\t\tconst response = await fetch(this.baseHttpUrl + `${this.apiPrefix}/datasets?${params.toString()}`, {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: this.headers()\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t\treturn response.json();\n\t}\n\t/**\n\t* Push datapoints to a dataset.\n\t*\n\t* @param {Object} options - Push options\n\t* @param {Datapoint<D, T>[]} options.points - Datapoints to push\n\t* @param {string} [options.name] - Name of the dataset (either name or id must be provided)\n\t* @param {StringUUID} [options.id] - ID of the dataset (either name or id must be provided)\n\t* @param {number} [options.batchSize] - Batch size for pushing (default: 100)\n\t* @param {boolean} [options.createDataset] - Whether to create the dataset if it doesn't exist\n\t* @returns {Promise<PushDatapointsResponse | undefined>}\n\t*/\n\tasync push({ points, name, id, batchSize = DEFAULT_DATASET_PUSH_BATCH_SIZE, createDataset = false }) {\n\t\tif (!name && !id) throw new Error(\"Either name or id must be provided\");\n\t\tif (name && id) throw new Error(\"Only one of name or id must be provided\");\n\t\tif (createDataset && !name) throw new Error(\"Name must be provided when creating a new dataset\");\n\t\tconst identifier = name ? { name } : { datasetId: id };\n\t\tconst totalBatches = Math.ceil(points.length / batchSize);\n\t\tlet response;\n\t\tfor (let i = 0; i < points.length; i += batchSize) {\n\t\t\tconst batchNum = Math.floor(i / batchSize) + 1;\n\t\t\tlogger$3.debug(`Pushing batch ${batchNum} of ${totalBatches}`);\n\t\t\tconst batch = points.slice(i, i + batchSize);\n\t\t\tconst fetchResponse = await fetch(this.baseHttpUrl + this.apiPrefix + \"/datasets/datapoints\", {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: this.headers(),\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\t...identifier,\n\t\t\t\t\tdatapoints: batch.map((point) => ({\n\t\t\t\t\t\tdata: point.data,\n\t\t\t\t\t\ttarget: point.target ?? {},\n\t\t\t\t\t\tmetadata: point.metadata ?? {}\n\t\t\t\t\t})),\n\t\t\t\t\tcreateDataset\n\t\t\t\t})\n\t\t\t});\n\t\t\tif (fetchResponse.status !== 200 && fetchResponse.status !== 201) await this.handleError(fetchResponse);\n\t\t\tresponse = await fetchResponse.json();\n\t\t}\n\t\treturn response;\n\t}\n\t/**\n\t* Pull datapoints from a dataset.\n\t*\n\t* @param {Object} options - Pull options\n\t* @param {string} [options.name] - Name of the dataset (either name or id must be provided)\n\t* @param {StringUUID} [options.id] - ID of the dataset (either name or id must be provided)\n\t* @param {number} [options.limit] - Maximum number of datapoints to return (default: 100)\n\t* @param {number} [options.offset] - Offset for pagination (default: 0)\n\t* @returns {Promise<GetDatapointsResponse<D, T>>}\n\t*/\n\tasync pull({ name, id, limit = DEFAULT_DATASET_PULL_LIMIT, offset = 0 }) {\n\t\tif (!name && !id) throw new Error(\"Either name or id must be provided\");\n\t\tif (name && id) throw new Error(\"Only one of name or id must be provided\");\n\t\tconst paramsObj = {\n\t\t\toffset: offset.toString(),\n\t\t\tlimit: limit.toString()\n\t\t};\n\t\tif (name) paramsObj.name = name;\n\t\telse paramsObj.datasetId = id;\n\t\tconst params = new URLSearchParams(paramsObj);\n\t\tconst response = await fetch(this.baseHttpUrl + `${this.apiPrefix}/datasets/datapoints?${params.toString()}`, {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: this.headers()\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t\treturn response.json();\n\t}\n};\n//#endregion\n//#region src/resources/evals.ts\nconst logger$2 = initializeLogger();\nconst INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH = 16e6;\nvar EvalsResource = class extends BaseResource {\n\tconstructor(baseHttpUrl, auth) {\n\t\tsuper(baseHttpUrl, auth);\n\t}\n\t/**\n\t* Initialize an evaluation.\n\t*\n\t* @param {string} name - Name of the evaluation\n\t* @param {string} groupName - Group name of the evaluation\n\t* @param {Record<string, any>} metadata - Optional metadata\n\t* @returns {Promise<InitEvaluationResponse>} Response from the evaluation initialization\n\t*/\n\tasync init(name, groupName, metadata) {\n\t\tconst response = await fetch(this.baseHttpUrl + \"/v1/evals\", {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.headers(),\n\t\t\tbody: JSON.stringify({\n\t\t\t\tname: name ?? null,\n\t\t\t\tgroupName: groupName ?? null,\n\t\t\t\tmetadata: metadata ?? null\n\t\t\t})\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t\treturn response.json();\n\t}\n\t/**\n\t* Create a new evaluation and return its ID.\n\t*\n\t* @param {string} [name] - Optional name of the evaluation\n\t* @param {string} [groupName] - An identifier to group evaluations\n\t* @param {Record<string, any>} [metadata] - Optional metadata\n\t* @returns {Promise<StringUUID>} The evaluation ID\n\t*/\n\tasync create(args) {\n\t\treturn (await this.init(args?.name, args?.groupName, args?.metadata)).id;\n\t}\n\t/**\n\t* Create a new evaluation and return its ID.\n\t* @deprecated use `create` instead.\n\t*/\n\tasync createEvaluation(name, groupName, metadata) {\n\t\treturn (await this.init(name, groupName, metadata)).id;\n\t}\n\t/**\n\t* Create a datapoint for an evaluation.\n\t*\n\t* @param {Object} options - Create datapoint options\n\t* @param {string} options.evalId - The evaluation ID\n\t* @param {D} options.data - The input data for the executor\n\t* @param {T} [options.target] - The target/expected output for evaluators\n\t* @param {Record<string, any>} [options.metadata] - Optional metadata\n\t* @param {number} [options.index] - Optional index of the datapoint\n\t* @param {string} [options.traceId] - Optional trace ID\n\t* @returns {Promise<StringUUID>} The datapoint ID\n\t*/\n\tasync createDatapoint({ evalId, data, target, metadata, index, traceId }) {\n\t\tconst datapointId = newUUID();\n\t\tconst partialDatapoint = {\n\t\t\tid: datapointId,\n\t\t\tdata,\n\t\t\ttarget,\n\t\t\tindex: index ?? 0,\n\t\t\ttraceId: traceId ?? newUUID(),\n\t\t\texecutorSpanId: newUUID(),\n\t\t\tmetadata\n\t\t};\n\t\tawait this.saveDatapoints({\n\t\t\tevalId,\n\t\t\tdatapoints: [partialDatapoint]\n\t\t});\n\t\treturn datapointId;\n\t}\n\t/**\n\t* Update a datapoint with evaluation results.\n\t*\n\t* @param {Object} options - Update datapoint options\n\t* @param {string} options.evalId - The evaluation ID\n\t* @param {string} options.datapointId - The datapoint ID\n\t* @param {Record<string, number>} options.scores - The scores\n\t* @param {O} [options.executorOutput] - The executor output\n\t* @returns {Promise<void>}\n\t*/\n\tasync updateDatapoint({ evalId, datapointId, scores, executorOutput }) {\n\t\tconst response = await fetch(this.baseHttpUrl + `/v1/evals/${evalId}/datapoints/${datapointId}`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.headers(),\n\t\t\tbody: JSON.stringify({\n\t\t\t\texecutorOutput,\n\t\t\t\tscores\n\t\t\t})\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t}\n\t/**\n\t* Save evaluation datapoints.\n\t*\n\t* @param {Object} options - Save datapoints options\n\t* @param {string} options.evalId - ID of the evaluation\n\t* @param {EvaluationDatapoint<D, T, O>[]} options.datapoints - Datapoint to add\n\t* @param {string} [options.groupName] - Group name of the evaluation\n\t* @returns {Promise<void>} Response from the datapoint addition\n\t*/\n\tasync saveDatapoints({ evalId, datapoints, groupName }) {\n\t\tconst response = await fetch(this.baseHttpUrl + `/v1/evals/${evalId}/datapoints`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.headers(),\n\t\t\tbody: JSON.stringify({\n\t\t\t\tpoints: datapoints.map((d) => ({\n\t\t\t\t\t...d,\n\t\t\t\t\tdata: slicePayload(d.data, INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH),\n\t\t\t\t\ttarget: slicePayload(d.target, INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH),\n\t\t\t\t\texecutorOutput: slicePayload(d.executorOutput, INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH)\n\t\t\t\t})),\n\t\t\t\tgroupName: groupName ?? null\n\t\t\t})\n\t\t});\n\t\tif (response.status === 413) return await this.retrySaveDatapoints({\n\t\t\tevalId,\n\t\t\tdatapoints,\n\t\t\tgroupName\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t}\n\t/**\n\t* Get evaluation datapoints.\n\t*\n\t* @deprecated Use `client.datasets.pull()` instead.\n\t* @param {Object} options - Get datapoints options\n\t* @param {string} options.datasetName - Name of the dataset\n\t* @param {number} options.offset - Offset at which to start the query\n\t* @param {number} options.limit - Maximum number of datapoints to return\n\t* @returns {Promise<GetDatapointsResponse>} Response from the datapoint retrieval\n\t*/\n\tasync getDatapoints({ datasetName, offset, limit }) {\n\t\tlogger$2.warn(\"evals.getDatapoints() is deprecated. Use client.datasets.pull() instead.\");\n\t\tconst params = new URLSearchParams({\n\t\t\tname: datasetName,\n\t\t\toffset: offset.toString(),\n\t\t\tlimit: limit.toString()\n\t\t});\n\t\tconst response = await fetch(this.baseHttpUrl + `/v1/datasets/datapoints?${params.toString()}`, {\n\t\t\tmethod: \"GET\",\n\t\t\theaders: this.headers()\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t\treturn await response.json();\n\t}\n\tasync retrySaveDatapoints({ evalId, datapoints, groupName, maxRetries = 25, initialLength = INITIAL_EVALUATION_DATAPOINT_MAX_DATA_LENGTH }) {\n\t\tlet length = initialLength;\n\t\tlet lastResponse = null;\n\t\tfor (let i = 0; i < maxRetries; i++) {\n\t\t\tlogger$2.debug(`Retrying save datapoints... ${i + 1} of ${maxRetries}, length: ${length}`);\n\t\t\tconst response = await fetch(this.baseHttpUrl + `/v1/evals/${evalId}/datapoints`, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: this.headers(),\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\tpoints: datapoints.map((d) => ({\n\t\t\t\t\t\t...d,\n\t\t\t\t\t\tdata: slicePayload(d.data, length),\n\t\t\t\t\t\ttarget: slicePayload(d.target, length),\n\t\t\t\t\t\texecutorOutput: slicePayload(d.executorOutput, length)\n\t\t\t\t\t})),\n\t\t\t\t\tgroupName: groupName ?? null\n\t\t\t\t})\n\t\t\t});\n\t\t\tlastResponse = response;\n\t\t\tlength = Math.floor(length / 2);\n\t\t\tif (response.status !== 413) break;\n\t\t}\n\t\tif (lastResponse && !lastResponse.ok) await this.handleError(lastResponse);\n\t}\n};\n//#endregion\n//#region src/resources/evaluators.ts\n/**\n* Resource for creating evaluator scores\n*/\nvar EvaluatorsResource = class extends BaseResource {\n\tconstructor(baseHttpUrl, auth) {\n\t\tsuper(baseHttpUrl, auth);\n\t}\n\t/**\n\t* Create a score for a span or trace\n\t*\n\t* @param {ScoreOptions} options - Score creation options\n\t* @param {string} options.name - Name of the score\n\t* @param {string} [options.traceId] - The trace ID to score (will be attached to top-level span)\n\t* @param {string} [options.spanId] - The span ID to score\n\t* @param {Record<string, any>} [options.metadata] - Additional metadata\n\t* @param {number} options.score - The score value (float)\n\t* @returns {Promise<void>}\n\t*\n\t* @example\n\t* // Score by trace ID (will attach to root span)\n\t* await evaluators.score({\n\t*   name: \"quality\",\n\t*   traceId: \"trace-id-here\",\n\t*   score: 0.95,\n\t*   metadata: { model: \"gpt-4\" }\n\t* });\n\t*\n\t* @example\n\t* // Score by span ID\n\t* await evaluators.score({\n\t*   name: \"relevance\",\n\t*   spanId: \"span-id-here\",\n\t*   score: 0.87\n\t* });\n\t*/\n\tasync score(options) {\n\t\tconst { name, metadata, score } = options;\n\t\tlet payload;\n\t\tif (\"traceId\" in options && options.traceId) payload = {\n\t\t\tname,\n\t\t\tmetadata,\n\t\t\tscore,\n\t\t\tsource: \"Code\",\n\t\t\ttraceId: isStringUUID(options.traceId) ? options.traceId : otelTraceIdToUUID(options.traceId)\n\t\t};\n\t\telse if (\"spanId\" in options && options.spanId) payload = {\n\t\t\tname,\n\t\t\tmetadata,\n\t\t\tscore,\n\t\t\tsource: \"Code\",\n\t\t\tspanId: isStringUUID(options.spanId) ? options.spanId : otelSpanIdToUUID(options.spanId)\n\t\t};\n\t\telse throw new Error(\"Either 'traceId' or 'spanId' must be provided.\");\n\t\tconst response = await fetch(this.baseHttpUrl + \"/v1/evaluators/score\", {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.headers(),\n\t\t\tbody: JSON.stringify(payload)\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t}\n};\n//#endregion\n//#region src/resources/rollout-sessions.ts\nconst logger$1 = initializeLogger();\n/**\n* Map the opaque HIT `response` payload onto a {@link CachedSpan} the provider\n* wrappers can replay. The server-side shape of `response` is not yet frozen\n* (app-server plan 01 leaves it as a `serde_json::Value`), so this stays\n* deliberately tolerant: the whole payload is serialized into `output` (the only\n* field the AI SDK wrapper's `parseCachedSpan` actually reads, via\n* `JSON.parse`), and a `finishReason` is surfaced into `attributes` when the\n* payload carries one. `name`/`input` are irrelevant to replay and left empty.\n*/\nconst toCachedSpan = (response) => {\n\tconst output = typeof response === \"string\" ? response : JSON.stringify(response ?? null);\n\tconst attributes = {};\n\tif (response !== null && typeof response === \"object\" && typeof response.finishReason === \"string\") attributes[\"ai.response.finishReason\"] = response.finishReason;\n\treturn {\n\t\tname: \"\",\n\t\tinput: \"\",\n\t\toutput,\n\t\tattributes\n\t};\n};\nvar RolloutSessionsResource = class extends BaseResource {\n\tconstructor(baseHttpUrl, auth) {\n\t\tsuper(baseHttpUrl, auth);\n\t}\n\t/**\n\t* Idempotently register (upsert) a debug session on the backend, keyed on the\n\t* SDK-supplied session id. The backend stores the row so the session is\n\t* visible in the UI; a null/omitted name never clobbers a name set elsewhere.\n\t*\n\t* Returns the backend-resolved `projectId` (derived from the API key) so the\n\t* caller can build the debugger URL; null if the body can't be parsed.\n\t*/\n\tasync register({ sessionId, name }) {\n\t\tconst response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.headers(),\n\t\t\tbody: JSON.stringify({ name })\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t\ttry {\n\t\t\treturn (await response.json()).projectId ?? null;\n\t\t} catch (e) {\n\t\t\tlogger$1.warn(`Failed to parse rollout register response: ${errorMessage(e)}`);\n\t\t\treturn null;\n\t\t}\n\t}\n\t/**\n\t* Rename an existing debug session. Update-only: the backend returns 404 (and\n\t* this throws) when the session id is unknown for the project, so a mistyped\n\t* id surfaces as an error rather than silently creating a session. Creation\n\t* stays the SDK's job via {@link register}.\n\t*/\n\tasync setName({ sessionId, name }) {\n\t\tconst response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}/name`, {\n\t\t\tmethod: \"PATCH\",\n\t\t\theaders: this.headers(),\n\t\t\tbody: JSON.stringify({ name })\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t}\n\t/**\n\t* Look up the debug-replay cache for a single LLM call (debug-replay v2).\n\t*\n\t* The server is keyed by `inputHash` (hex blake3 of the canonicalized,\n\t* system-stripped input messages). It returns one of three outcomes:\n\t*   - `{ outcome: \"hit\", response }` — a cached response to replay.\n\t*   - `{ outcome: \"miss\" }`          — no entry; caller latches live mode.\n\t*   - `{ outcome: \"live\" }`          — run this call live (COLD degrade).\n\t*\n\t* Error posture: a non-OK response or a transport error degrades to\n\t* `{ kind: \"live\" }` for THIS call only — it never throws and never latches\n\t* the process-wide live flag (only a real MISS does that). This keeps a flaky\n\t* cache backend from turning a replay into a crash.\n\t*/\n\tasync cache({ sessionId, replayTraceId, cacheUntil, inputHash }) {\n\t\tlet response;\n\t\ttry {\n\t\t\tresponse = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}/cache`, {\n\t\t\t\tmethod: \"POST\",\n\t\t\t\theaders: this.headers(),\n\t\t\t\tbody: JSON.stringify({\n\t\t\t\t\treplayTraceId,\n\t\t\t\t\tcacheUntil,\n\t\t\t\t\tinputHash\n\t\t\t\t})\n\t\t\t});\n\t\t} catch (e) {\n\t\t\tlogger$1.warn(`Debug cache lookup failed, running live: ${errorMessage(e)}`);\n\t\t\treturn { kind: \"live\" };\n\t\t}\n\t\tif (!response.ok) {\n\t\t\tlogger$1.warn(`Debug cache lookup returned ${response.status}, running live`);\n\t\t\treturn { kind: \"live\" };\n\t\t}\n\t\tlet body;\n\t\ttry {\n\t\t\tbody = await response.json();\n\t\t} catch (e) {\n\t\t\tlogger$1.warn(`Failed to parse debug cache response, running live: ${errorMessage(e)}`);\n\t\t\treturn { kind: \"live\" };\n\t\t}\n\t\tswitch (body.outcome) {\n\t\t\tcase \"hit\":\n\t\t\t\tif (body.response === null || body.response === void 0) {\n\t\t\t\t\tlogger$1.warn(\"Debug cache HIT had no response payload, running live\");\n\t\t\t\t\treturn { kind: \"live\" };\n\t\t\t\t}\n\t\t\t\treturn {\n\t\t\t\t\tkind: \"hit\",\n\t\t\t\t\tcached: toCachedSpan(body.response)\n\t\t\t\t};\n\t\t\tcase \"miss\": return { kind: \"miss\" };\n\t\t\tcase \"live\": return { kind: \"live\" };\n\t\t\tdefault:\n\t\t\t\tlogger$1.warn(`Unknown debug cache outcome \"${body.outcome}\", running live`);\n\t\t\t\treturn { kind: \"live\" };\n\t\t}\n\t}\n\tasync delete({ sessionId }) {\n\t\tconst response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/rollouts/${sessionId}`, {\n\t\t\tmethod: \"DELETE\",\n\t\t\theaders: this.headers()\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t}\n};\n//#endregion\n//#region src/resources/sql.ts\nvar SqlResource = class extends BaseResource {\n\tconstructor(baseHttpUrl, auth) {\n\t\tsuper(baseHttpUrl, auth);\n\t}\n\tasync query(sql, parameters = {}) {\n\t\tconst response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/sql/query`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: { ...this.headers() },\n\t\t\tbody: JSON.stringify({\n\t\t\t\tquery: sql,\n\t\t\t\tparameters\n\t\t\t})\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t\treturn (await response.json()).data;\n\t}\n};\n//#endregion\n//#region src/resources/tags.ts\n/** Resource for tagging traces. */\nvar TagsResource = class extends BaseResource {\n\t/** Resource for tagging traces. */\n\tconstructor(baseHttpUrl, auth) {\n\t\tsuper(baseHttpUrl, auth);\n\t}\n\t/**\n\t* Tag a trace with a list of tags. Note that the trace must be ended before\n\t* tagging it. You may want to call `await Laminar.flush()` after the trace\n\t* that you want to tag.\n\t*\n\t* @param {string | StringUUID} trace_id - The trace id to tag.\n\t* @param {string[] | string} tags - The tag or list of tags to add to the trace.\n\t* @returns {Promise<any>} The response from the server.\n\t* @example\n\t* ```javascript\n\t* import { Laminar, observe, LaminarClient } from \"@lmnr-ai/lmnr\";\n\t* Laminar.initialize();\n\t* const client = new LaminarClient();\n\t* let traceId: StringUUID | null = null;\n\t* // Make sure this is called outside of traced context.\n\t* await observe(\n\t*   {\n\t*     name: \"my-trace\",\n\t*   },\n\t*   async () => {\n\t*     traceId = await Laminar.getTraceId();\n\t*     await foo();\n\t*   },\n\t* );\n\t*\n\t* // or make sure the trace is ended by this point.\n\t* await Laminar.flush();\n\t* if (traceId) {\n\t*   await client.tags.tag(traceId, [\"tag1\", \"tag2\"]);\n\t* }\n\t* ```\n\t*/\n\tasync tag(trace_id, tags) {\n\t\tconst traceTags = Array.isArray(tags) ? tags : [tags];\n\t\tconst formattedTraceId = isStringUUID(trace_id) ? trace_id : otelTraceIdToUUID(trace_id);\n\t\tconst url = this.baseHttpUrl + \"/v1/tag\";\n\t\tconst payload = {\n\t\t\t\"traceId\": formattedTraceId,\n\t\t\t\"names\": traceTags\n\t\t};\n\t\tconst response = await fetch(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.headers(),\n\t\t\tbody: JSON.stringify(payload)\n\t\t});\n\t\tif (!response.ok) await this.handleError(response);\n\t\treturn response.json();\n\t}\n};\n//#endregion\n//#region src/resources/traces.ts\n/** Resource for post-factum operations on existing traces. */\nconst logger = initializeLogger();\nvar TracesResource = class extends BaseResource {\n\t/** Resource for post-factum operations on existing traces. */\n\tconstructor(baseHttpUrl, auth) {\n\t\tsuper(baseHttpUrl, auth);\n\t}\n\t/**\n\t* Push a metadata patch to an existing trace.\n\t*\n\t* The patch is shallow-merged server-side into the trace's existing metadata\n\t* (`existing || patch`, last-write-wins per top-level key). Useful for\n\t* attaching post-factum signals — quality scores, human edits, triage labels —\n\t* to a trace that has already finished. The patch does NOT extend `endTime`\n\t* or change tokens / cost / top span / tags / span names. `numSpans` is\n\t* incremented by 1 (paid by the virtual span that carried the patch through\n\t* the ingestion queue) so the new ClickHouse row beats the prior version on\n\t* `ReplacingMergeTree(numSpans)`. No row is added to the `spans` table.\n\t*\n\t* Compared to `Laminar.setTraceMetadata` (which sets metadata on the\n\t* currently in-flight trace via OpenTelemetry attributes), this method\n\t* operates on a finished trace by trace id, so it must be called after the\n\t* trace has been flushed.\n\t*\n\t* A 404 response (the trace was not found in the project — typically because\n\t* it has not been flushed yet) is logged as a warning and the call returns\n\t* without throwing, since the 404 may be expected when pushing too soon\n\t* after the trace run. Pass `failOnNotFound: true` to throw instead (e.g.\n\t* CLI callers that must report the failure). Any other non-OK status throws.\n\t*\n\t* @param traceId - The trace id to push metadata to. Accepts a UUID string\n\t*   or a 32-char OTel hex trace id.\n\t* @param metadata - The metadata patch. Top-level keys are merged into the\n\t*   trace's existing metadata. Must be non-empty (the server rejects empty\n\t*   patches with 400).\n\t* @param options - `failOnNotFound`: throw on 404 instead of warn-and-return.\n\t* @example\n\t* ```typescript\n\t* import { Laminar, observe, LaminarClient } from \"@lmnr-ai/lmnr\";\n\t* Laminar.initialize();\n\t* const client = new LaminarClient();\n\t*\n\t* let traceId: string | null = null;\n\t* await observe({ name: \"generate\" }, async () => {\n\t*   traceId = await Laminar.getTraceId();\n\t* });\n\t* await Laminar.flush();\n\t*\n\t* if (traceId) {\n\t*   await client.traces.pushMetadata(traceId, {\n\t*     score: 0.85,\n\t*     reviewer: \"alice\",\n\t*     needsReview: false,\n\t*   });\n\t* }\n\t* ```\n\t*/\n\tasync pushMetadata(traceId, metadata, options) {\n\t\tif (!metadata || Object.keys(metadata).length === 0) throw new Error(\"metadata must be a non-empty object\");\n\t\tconst formattedTraceId = isStringUUID(traceId) ? traceId : otelTraceIdToUUID(traceId);\n\t\tconst url = this.baseHttpUrl + this.apiPrefix + \"/traces/metadata\";\n\t\tconst response = await fetch(url, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.headers(),\n\t\t\tbody: JSON.stringify({\n\t\t\t\ttraceId: formattedTraceId,\n\t\t\t\tmetadata\n\t\t\t})\n\t\t});\n\t\tif (response.status === 404) {\n\t\t\tconst message = `Trace ${formattedTraceId} not found. The trace may not have been flushed yet — call await Laminar.flush() and retry.`;\n\t\t\tif (options?.failOnNotFound) throw new Error(message);\n\t\t\tlogger.warn(message);\n\t\t\treturn;\n\t\t}\n\t\tif (!response.ok) await this.handleError(response);\n\t}\n};\n//#endregion\n//#region src/index.ts\nvar LaminarClient = class LaminarClient {\n\tconstructor({ baseUrl, port, auth, projectApiKey, cliUserProjectId } = {}) {\n\t\tloadEnv();\n\t\tthis.auth = LaminarClient.normalizeAuth(auth, projectApiKey, cliUserProjectId);\n\t\tconst httpPort = port ?? (baseUrl?.match(/:\\d{1,5}$/g) ? parseInt(baseUrl.match(/:\\d{1,5}$/g)[0].slice(1)) : 443);\n\t\tconst baseUrlNoPort = (baseUrl ?? process.env.LMNR_BASE_URL)?.replace(/\\/$/, \"\").replace(/:\\d{1,5}$/g, \"\");\n\t\tthis.baseUrl = `${baseUrlNoPort ?? \"https://api.lmnr.ai\"}:${httpPort}`;\n\t\tthis._browserEvents = new BrowserEventsResource(this.baseUrl, this.auth);\n\t\tthis._cli = new CliResource(this.baseUrl, this.auth);\n\t\tthis._datasets = new DatasetsResource(this.baseUrl, this.auth);\n\t\tthis._evals = new EvalsResource(this.baseUrl, this.auth);\n\t\tthis._evaluators = new EvaluatorsResource(this.baseUrl, this.auth);\n\t\tthis._rolloutSessions = new RolloutSessionsResource(this.baseUrl, this.auth);\n\t\tthis._sql = new SqlResource(this.baseUrl, this.auth);\n\t\tthis._tags = new TagsResource(this.baseUrl, this.auth);\n\t\tthis._traces = new TracesResource(this.baseUrl, this.auth);\n\t}\n\t/**\n\t* Normalize the constructor's auth inputs into a {@link LaminarAuth} union.\n\t* Precedence: an explicit `auth` wins; otherwise the legacy\n\t* `projectApiKey` (+ optional `cliUserProjectId`) is mapped — a present\n\t* `cliUserProjectId` selects the user-token surface, otherwise the project\n\t* key surface. Falls back to `LMNR_PROJECT_API_KEY` as a project key.\n\t*/\n\tstatic normalizeAuth(auth, projectApiKey, cliUserProjectId) {\n\t\tif (auth) return auth;\n\t\tconst key = projectApiKey ?? process.env.LMNR_PROJECT_API_KEY;\n\t\tif (cliUserProjectId) return {\n\t\t\ttype: \"userToken\",\n\t\t\ttoken: key,\n\t\t\tprojectId: cliUserProjectId\n\t\t};\n\t\treturn {\n\t\t\ttype: \"apiKey\",\n\t\t\tkey\n\t\t};\n\t}\n\tget browserEvents() {\n\t\treturn this._browserEvents;\n\t}\n\tget cli() {\n\t\treturn this._cli;\n\t}\n\tget datasets() {\n\t\treturn this._datasets;\n\t}\n\tget evals() {\n\t\treturn this._evals;\n\t}\n\tget evaluators() {\n\t\treturn this._evaluators;\n\t}\n\tget rolloutSessions() {\n\t\treturn this._rolloutSessions;\n\t}\n\tget sql() {\n\t\treturn this._sql;\n\t}\n\tget tags() {\n\t\treturn this._tags;\n\t}\n\tget traces() {\n\t\treturn this._traces;\n\t}\n};\n//#endregion\nexport { LaminarClient, RolloutSessionsResource };\n\n//# sourceMappingURL=index.mjs.map"],"mappings":"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"}

package/dist/{evaluations-Db2jWbjf.d.cts → evaluations-DLNweSzE.d.cts}

@@ -173,11 +173,34 @@ type Event = {
 //#endregion
 //#region ../client/dist/index.d.cts
 //#region src/resources/index.d.ts
+/**
+ * Unified auth for every resource. A discriminated union so a single object
+ * drives both the URL prefix and the request headers:
+ *
+ *  - `apiKey`    → project API key (SDK / app surfaces). Routes to `/v1/*`,
+ *    Bearer is the project key, no `x-lmnr-project-id` header.
+ *  - `userToken` → BetterAuth user access JWT (the CLI user-token surface).
+ *    Routes to `/v1/cli/*`, Bearer is the JWT, carries the target project in
+ *    the `x-lmnr-project-id` header.
+ */
+type LaminarAuth = {
+  type: "apiKey";
+  key: string;
+} | {
+  type: "userToken";
+  token: string;
+  projectId: string;
+};
 declare class BaseResource {
   protected readonly baseHttpUrl: string;
-  protected readonly projectApiKey: string;
-  constructor(baseHttpUrl: string, projectApiKey: string);
+  protected readonly auth: LaminarAuth;
+  /** The bearer credential, regardless of auth type (project key or user JWT). */
+  protected readonly credential: string;
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
+  /** API path prefix: `/v1/cli` for CLI user-token auth, `/v1` otherwise. */
+  protected get apiPrefix(): string;
   protected headers(): {
+    "x-lmnr-project-id"?: string | undefined;
     Authorization: string;
     "Content-Type": string;
     Accept: string;
@@ -186,7 +209,7 @@ declare class BaseResource {
 } //#endregion
 //#region src/resources/browser-events.d.ts
 declare class BrowserEventsResource extends BaseResource {
-  constructor(baseHttpUrl: string, projectApiKey: string);
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
   send({
     sessionId,
     traceId,
@@ -197,9 +220,30 @@ declare class BrowserEventsResource extends BaseResource {
     events: Record<string, any>[];
   }): Promise<void>;
 } //#endregion
+//#region src/resources/cli.d.ts
+interface CliProject {
+  id: string;
+  name: string;
+  workspaceId: string;
+  workspaceName: string;
+}
+/**
+ * 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.
+ */
+declare class CliResource extends BaseResource {
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
+  /** Workspaces + projects the authenticated user can access. */
+  listProjects(): Promise<CliProject[]>;
+} //#endregion
 //#region src/resources/datasets.d.ts
 declare class DatasetsResource extends BaseResource {
-  constructor(baseHttpUrl: string, projectApiKey: string);
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
   /**
    * List all datasets.
    *
@@ -261,7 +305,7 @@ declare class DatasetsResource extends BaseResource {
 } //#endregion
 //#region src/resources/evals.d.ts
 declare class EvalsResource extends BaseResource {
-  constructor(baseHttpUrl: string, projectApiKey: string);
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
   /**
    * Initialize an evaluation.
    *
@@ -392,7 +436,7 @@ type ScoreOptions = {
  * Resource for creating evaluator scores
  */
 declare class EvaluatorsResource extends BaseResource {
-  constructor(baseHttpUrl: string, projectApiKey: string);
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
   /**
    * Create a score for a span or trace
    *
@@ -443,7 +487,7 @@ type CacheOutcome = {
   kind: "live";
 };
 declare class RolloutSessionsResource extends BaseResource {
-  constructor(baseHttpUrl: string, projectApiKey: string);
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
   /**
    * Idempotently register (upsert) a debug session on the backend, keyed on the
    * SDK-supplied session id. The backend stores the row so the session is
@@ -505,13 +549,13 @@ declare class RolloutSessionsResource extends BaseResource {
 } //#endregion
 //#region src/resources/sql.d.ts
 declare class SqlResource extends BaseResource {
-  constructor(baseHttpUrl: string, projectApiKey: string);
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
   query(sql: string, parameters?: Record<string, any>): Promise<Array<Record<string, any>>>;
 } //#endregion
 //#region src/resources/tags.d.ts
 declare class TagsResource extends BaseResource {
   /** Resource for tagging traces. */
-  constructor(baseHttpUrl: string, projectApiKey: string);
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
   /**
    * Tag a trace with a list of tags. Note that the trace must be ended before
    * tagging it. You may want to call `await Laminar.flush()` after the trace
@@ -549,7 +593,7 @@ declare class TagsResource extends BaseResource {
 //#region src/resources/traces.d.ts
 declare class TracesResource extends BaseResource {
   /** Resource for post-factum operations on existing traces. */
-  constructor(baseHttpUrl: string, projectApiKey: string);
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
   /**
    * Push a metadata patch to an existing trace.
    *
@@ -607,8 +651,9 @@ declare class TracesResource extends BaseResource {
 //#region src/index.d.ts
 declare class LaminarClient {
   private baseUrl;
-  private projectApiKey;
+  private auth;
   private _browserEvents;
+  private _cli;
   private _datasets;
   private _evals;
   private _evaluators;
@@ -618,14 +663,45 @@ declare class LaminarClient {
   private _traces;
   constructor({
     baseUrl,
+    port,
+    auth,
     projectApiKey,
-    port
+    cliUserProjectId
   }?: {
     baseUrl?: string;
-    projectApiKey?: string;
     port?: number;
+    /**
+     * Unified auth. A discriminated union that drives both the URL prefix and
+     * the request headers:
+     *  - `{ type: "apiKey", key }`               → project key, `/v1/*`.
+     *  - `{ type: "userToken", token, projectId }` → user JWT, `/v1/cli/*` with
+     *    `x-lmnr-project-id`.
+     * When omitted, the legacy `projectApiKey` / `cliUserProjectId` fields (or
+     * `LMNR_PROJECT_API_KEY`) are normalized into this union.
+     */
+    auth?: LaminarAuth;
+    /**
+     * @deprecated Pass `auth: { type: "apiKey", key }` instead. Kept for
+     * backward compatibility — normalized into the unified `auth` union.
+     */
+    projectApiKey?: string;
+    /**
+     * @deprecated Pass `auth: { type: "userToken", token, projectId }` instead.
+     * Kept for backward compatibility: when set, the legacy `projectApiKey` is
+     * treated as a user JWT and routes to `/v1/cli/*` with this project id.
+     */
+    cliUserProjectId?: string;
   });
+  /**
+   * Normalize the constructor's auth inputs into a {@link LaminarAuth} union.
+   * Precedence: an explicit `auth` wins; otherwise the legacy
+   * `projectApiKey` (+ optional `cliUserProjectId`) is mapped — a present
+   * `cliUserProjectId` selects the user-token surface, otherwise the project
+   * key surface. Falls back to `LMNR_PROJECT_API_KEY` as a project key.
+   */
+  private static normalizeAuth;
   get browserEvents(): BrowserEventsResource;
+  get cli(): CliResource;
   get datasets(): DatasetsResource;
   get evals(): EvalsResource;
   get evaluators(): EvaluatorsResource;
@@ -31158,4 +31234,4 @@ declare function evaluate<D, T, O>({
 }: EvaluationConstructorProps<D, T, O>): Promise<EvaluationRunResult | undefined>;
 //#endregion
 export { __exportAll as C, TracingLevel as S, MaskInputOptions as _, HumanEvaluator as a, SpanType as b, InitializeOptions as c, LaminarClient as d, Dataset as f, LaminarSpanContext as g, Event as h, EvaluatorFunctionReturn as i, EvaluationDataset as l, EvaluationDatapointDatasetLink as m, Evaluation as n, evaluate as o, EvaluationDatapoint as p, EvaluatorFunction as r, StringUUID as s, Datapoint as t, LaminarDataset as u, PushDatapointsResponse as v, TraceType as x, SessionRecordingOptions as y };
-//# sourceMappingURL=evaluations-Db2jWbjf.d.cts.map
+//# sourceMappingURL=evaluations-DLNweSzE.d.cts.map