@lmnr-ai/client 0.8.44 → 0.8.46

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { CachedSpan, Datapoint, Dataset, EvaluationDatapoint, GetDatapointsResponse, InitEvaluationResponse, PushDatapointsResponse, SessionBlock, SessionBlockContent, SessionBlockType, Signal, SignalFilter, SignalMode, SignalStructuredOutput, SignalTrigger, SqlSchema, StringUUID } from "@lmnr-ai/types";
+import { CachedSpan, Datapoint, Dataset, EvaluationDatapoint, GetDatapointsResponse, InitEvaluationResponse, LlmProfile, LlmProfileConfig, LlmProfileProvider, PushDatapointsResponse, SessionBlock, SessionBlockContent, SessionBlockType, Signal, SignalFilter, SignalMode, SignalStructuredOutput, SignalTrigger, SignalVersion, SqlSchema, StringUUID } from "@lmnr-ai/types";
 
 //#region src/resources/index.d.ts
 /**
@@ -107,6 +107,14 @@ declare class DatasetsResource extends BaseResource {
    * @returns {Promise<Dataset[]>} Array of datasets
    */
   listDatasets(): Promise<Dataset[]>;
+  /** Create an empty dataset. */
+  create(name: string): Promise<Dataset>;
+  /** Get a dataset by its canonical UUID. */
+  getById(datasetId: StringUUID): Promise<Dataset>;
+  /** Rename a dataset. */
+  update(datasetId: StringUUID, name: string): Promise<Dataset>;
+  /** Delete a dataset and its datapoints. */
+  delete(datasetId: StringUUID): Promise<Dataset>;
   /**
    * Get a dataset by name.
    *
@@ -346,6 +354,67 @@ declare class EvaluatorsResource extends BaseResource {
   score(options: ScoreOptions): Promise<void>;
 }
 //#endregion
+//#region src/resources/llm-profiles.d.ts
+/**
+ * Plaintext secrets for create/update. On update this is an OVERLAY: an
+ * omitted key keeps the stored secret, so credentials never need re-sending.
+ */
+interface LlmProfileSecretsInput {
+  apiKey?: string;
+  secretAccessKey?: string;
+  token?: string;
+  /** Values for the `custom` provider's `config.headerNames`. */
+  headers?: Record<string, string>;
+}
+interface CreateLlmProfileOptions {
+  name: string;
+  provider: LlmProfileProvider;
+  /** Omitted `auth` defaults to `{type: "api_key"}`. */
+  config?: Partial<LlmProfileConfig>;
+  secrets?: LlmProfileSecretsInput;
+  models: string[];
+}
+/**
+ * A partial patch: omitted fields keep their stored value. `models` replaces
+ * the whole list when present; `config` is required when `provider` changes.
+ */
+interface UpdateLlmProfileOptions {
+  name?: string;
+  provider?: LlmProfileProvider;
+  config?: Partial<LlmProfileConfig>;
+  secrets?: LlmProfileSecretsInput;
+  models?: string[];
+}
+/**
+ * Workspace LLM profile CRUD over the CLI user-token surface
+ * (`/v1/cli/llm-profiles`). Validation is entirely server-side; error messages
+ * come back user-ready. Self-hosted only: on Laminar Cloud every route 404s
+ * with `{error: "LLM profiles are not available on this deployment"}`.
+ */
+declare class LlmProfilesResource extends BaseResource {
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
+  /**
+   * Errors come back as `{error: string}` (matches the signals surface) with
+   * user-facing text, so unwrap the envelope before raising rather than
+   * showing the raw JSON body.
+   */
+  private raiseLlmProfileError;
+  private request;
+  /**
+   * Every workspace LLM profile visible to the caller, ordered
+   * case-insensitively by name. Empty array on a workspace with no profiles.
+   */
+  list(): Promise<LlmProfile[]>;
+  get(profileId: string): Promise<LlmProfile>;
+  create(options: CreateLlmProfileOptions): Promise<LlmProfile>;
+  update(profileId: string, options: UpdateLlmProfileOptions): Promise<LlmProfile>;
+  /**
+   * Deletes the profile and returns it. The server refuses (409) when any
+   * signal still routes through the profile.
+   */
+  delete(profileId: string): Promise<LlmProfile>;
+}
+//#endregion
 //#region src/resources/rollout-sessions.d.ts
 /**
  * Result of a debug-replay cache lookup (debug-replay v2).
@@ -482,10 +551,20 @@ interface CreateSignalOptions {
   filters?: SignalFilter[];
   /** Defaults to `"realtime"`. */
   mode?: SignalMode;
+  /**
+   * Workspace LLM profile id (discover via `llmProfiles.list()`). Required
+   * together with `model` on self-hosted deployments; rejected on Laminar
+   * Cloud (the server has env-configured LLMs).
+   */
+  llmProfileId?: string;
+  /** One of the profile's models. Required together with `llmProfileId`. */
+  model?: string;
 }
 /**
  * A partial patch. Every field is optional and an ABSENT field leaves the stored
  * value alone. `sampleRate: null` clears sampling, `filters: []` clears filters.
+ * `llmProfileId` + `model` must be sent together to re-route; the wire has no
+ * shape for clearing the route back to the server's env LLM.
  */
 interface UpdateSignalOptions {
   prompt?: string;
@@ -495,6 +574,8 @@ interface UpdateSignalOptions {
   trigger?: SignalTrigger;
   filters?: SignalFilter[];
   mode?: SignalMode;
+  llmProfileId?: string;
+  model?: string;
 }
 /** Signals CRUD over the CLI user-token surface (`/v1/cli/signals`). */
 declare class SignalsResource extends BaseResource {
@@ -509,6 +590,13 @@ declare class SignalsResource extends BaseResource {
   private raiseSignalError;
   list(name?: string): Promise<Signal[]>;
   get(signalId: string): Promise<Signal>;
+  /**
+   * Historical judge definitions for `signalId`, oldest first. Distinct from
+   * `GET /signals/{id}`'s `version` field, which is only the current pointer.
+   * 404 if that id isn't in this project; an empty list only if the signal
+   * exists with no version rows.
+   */
+  listVersions(signalId: string): Promise<SignalVersion[]>;
   create(options: CreateSignalOptions): Promise<Signal>;
   /**
    * PATCH, not PUT: only the keys present in `options` are sent, so the server
@@ -640,6 +728,7 @@ declare class LaminarClient {
   private _datasets;
   private _evals;
   private _evaluators;
+  private _llmProfiles;
   private _rolloutSessions;
   private _signals;
   private _sql;
@@ -712,6 +801,7 @@ declare class LaminarClient {
   get datasets(): DatasetsResource;
   get evals(): EvalsResource;
   get evaluators(): EvaluatorsResource;
+  get llmProfiles(): LlmProfilesResource;
   get signals(): SignalsResource;
   get rolloutSessions(): RolloutSessionsResource;
   get sql(): SqlResource;
@@ -719,5 +809,5 @@ declare class LaminarClient {
   get traces(): TracesResource;
 }
 //#endregion
-export { type CacheOutcome, type CliProject, type CreateSignalOptions, type LaminarAuth, LaminarClient, type ProjectKeyProbe, RolloutSessionsResource, type UpdateSignalOptions };
+export { type CacheOutcome, type CliProject, type CreateLlmProfileOptions, type CreateSignalOptions, type LaminarAuth, LaminarClient, type LlmProfileSecretsInput, type ProjectKeyProbe, RolloutSessionsResource, type UpdateLlmProfileOptions, type UpdateSignalOptions };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { CachedSpan, Datapoint, Dataset, EvaluationDatapoint, GetDatapointsResponse, InitEvaluationResponse, PushDatapointsResponse, SessionBlock, SessionBlockContent, SessionBlockType, Signal, SignalFilter, SignalMode, SignalStructuredOutput, SignalTrigger, SqlSchema, StringUUID } from "@lmnr-ai/types";
+import { CachedSpan, Datapoint, Dataset, EvaluationDatapoint, GetDatapointsResponse, InitEvaluationResponse, LlmProfile, LlmProfileConfig, LlmProfileProvider, PushDatapointsResponse, SessionBlock, SessionBlockContent, SessionBlockType, Signal, SignalFilter, SignalMode, SignalStructuredOutput, SignalTrigger, SignalVersion, SqlSchema, StringUUID } from "@lmnr-ai/types";
 
 //#region src/resources/index.d.ts
 /**
@@ -107,6 +107,14 @@ declare class DatasetsResource extends BaseResource {
    * @returns {Promise<Dataset[]>} Array of datasets
    */
   listDatasets(): Promise<Dataset[]>;
+  /** Create an empty dataset. */
+  create(name: string): Promise<Dataset>;
+  /** Get a dataset by its canonical UUID. */
+  getById(datasetId: StringUUID): Promise<Dataset>;
+  /** Rename a dataset. */
+  update(datasetId: StringUUID, name: string): Promise<Dataset>;
+  /** Delete a dataset and its datapoints. */
+  delete(datasetId: StringUUID): Promise<Dataset>;
   /**
    * Get a dataset by name.
    *
@@ -346,6 +354,67 @@ declare class EvaluatorsResource extends BaseResource {
   score(options: ScoreOptions): Promise<void>;
 }
 //#endregion
+//#region src/resources/llm-profiles.d.ts
+/**
+ * Plaintext secrets for create/update. On update this is an OVERLAY: an
+ * omitted key keeps the stored secret, so credentials never need re-sending.
+ */
+interface LlmProfileSecretsInput {
+  apiKey?: string;
+  secretAccessKey?: string;
+  token?: string;
+  /** Values for the `custom` provider's `config.headerNames`. */
+  headers?: Record<string, string>;
+}
+interface CreateLlmProfileOptions {
+  name: string;
+  provider: LlmProfileProvider;
+  /** Omitted `auth` defaults to `{type: "api_key"}`. */
+  config?: Partial<LlmProfileConfig>;
+  secrets?: LlmProfileSecretsInput;
+  models: string[];
+}
+/**
+ * A partial patch: omitted fields keep their stored value. `models` replaces
+ * the whole list when present; `config` is required when `provider` changes.
+ */
+interface UpdateLlmProfileOptions {
+  name?: string;
+  provider?: LlmProfileProvider;
+  config?: Partial<LlmProfileConfig>;
+  secrets?: LlmProfileSecretsInput;
+  models?: string[];
+}
+/**
+ * Workspace LLM profile CRUD over the CLI user-token surface
+ * (`/v1/cli/llm-profiles`). Validation is entirely server-side; error messages
+ * come back user-ready. Self-hosted only: on Laminar Cloud every route 404s
+ * with `{error: "LLM profiles are not available on this deployment"}`.
+ */
+declare class LlmProfilesResource extends BaseResource {
+  constructor(baseHttpUrl: string, auth: LaminarAuth);
+  /**
+   * Errors come back as `{error: string}` (matches the signals surface) with
+   * user-facing text, so unwrap the envelope before raising rather than
+   * showing the raw JSON body.
+   */
+  private raiseLlmProfileError;
+  private request;
+  /**
+   * Every workspace LLM profile visible to the caller, ordered
+   * case-insensitively by name. Empty array on a workspace with no profiles.
+   */
+  list(): Promise<LlmProfile[]>;
+  get(profileId: string): Promise<LlmProfile>;
+  create(options: CreateLlmProfileOptions): Promise<LlmProfile>;
+  update(profileId: string, options: UpdateLlmProfileOptions): Promise<LlmProfile>;
+  /**
+   * Deletes the profile and returns it. The server refuses (409) when any
+   * signal still routes through the profile.
+   */
+  delete(profileId: string): Promise<LlmProfile>;
+}
+//#endregion
 //#region src/resources/rollout-sessions.d.ts
 /**
  * Result of a debug-replay cache lookup (debug-replay v2).
@@ -482,10 +551,20 @@ interface CreateSignalOptions {
   filters?: SignalFilter[];
   /** Defaults to `"realtime"`. */
   mode?: SignalMode;
+  /**
+   * Workspace LLM profile id (discover via `llmProfiles.list()`). Required
+   * together with `model` on self-hosted deployments; rejected on Laminar
+   * Cloud (the server has env-configured LLMs).
+   */
+  llmProfileId?: string;
+  /** One of the profile's models. Required together with `llmProfileId`. */
+  model?: string;
 }
 /**
  * A partial patch. Every field is optional and an ABSENT field leaves the stored
  * value alone. `sampleRate: null` clears sampling, `filters: []` clears filters.
+ * `llmProfileId` + `model` must be sent together to re-route; the wire has no
+ * shape for clearing the route back to the server's env LLM.
  */
 interface UpdateSignalOptions {
   prompt?: string;
@@ -495,6 +574,8 @@ interface UpdateSignalOptions {
   trigger?: SignalTrigger;
   filters?: SignalFilter[];
   mode?: SignalMode;
+  llmProfileId?: string;
+  model?: string;
 }
 /** Signals CRUD over the CLI user-token surface (`/v1/cli/signals`). */
 declare class SignalsResource extends BaseResource {
@@ -509,6 +590,13 @@ declare class SignalsResource extends BaseResource {
   private raiseSignalError;
   list(name?: string): Promise<Signal[]>;
   get(signalId: string): Promise<Signal>;
+  /**
+   * Historical judge definitions for `signalId`, oldest first. Distinct from
+   * `GET /signals/{id}`'s `version` field, which is only the current pointer.
+   * 404 if that id isn't in this project; an empty list only if the signal
+   * exists with no version rows.
+   */
+  listVersions(signalId: string): Promise<SignalVersion[]>;
   create(options: CreateSignalOptions): Promise<Signal>;
   /**
    * PATCH, not PUT: only the keys present in `options` are sent, so the server
@@ -640,6 +728,7 @@ declare class LaminarClient {
   private _datasets;
   private _evals;
   private _evaluators;
+  private _llmProfiles;
   private _rolloutSessions;
   private _signals;
   private _sql;
@@ -712,6 +801,7 @@ declare class LaminarClient {
   get datasets(): DatasetsResource;
   get evals(): EvalsResource;
   get evaluators(): EvaluatorsResource;
+  get llmProfiles(): LlmProfilesResource;
   get signals(): SignalsResource;
   get rolloutSessions(): RolloutSessionsResource;
   get sql(): SqlResource;
@@ -719,5 +809,5 @@ declare class LaminarClient {
   get traces(): TracesResource;
 }
 //#endregion
-export { type CacheOutcome, type CliProject, type CreateSignalOptions, type LaminarAuth, LaminarClient, type ProjectKeyProbe, RolloutSessionsResource, type UpdateSignalOptions };
+export { type CacheOutcome, type CliProject, type CreateLlmProfileOptions, type CreateSignalOptions, type LaminarAuth, LaminarClient, type LlmProfileSecretsInput, type ProjectKeyProbe, RolloutSessionsResource, type UpdateLlmProfileOptions, type UpdateSignalOptions };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -5,7 +5,7 @@ import { PinoPretty } from "pino-pretty";
 import { v4 } from "uuid";
 import { errorMessage } from "@lmnr-ai/types";
 //#region package.json
-var version = "0.8.44";
+var version = "0.8.46";
 //#endregion
 //#region src/version.ts
 function getLangVersion() {
@@ -215,6 +215,44 @@ var DatasetsResource = class extends BaseResource {
 		if (!response.ok) await this.handleError(response);
 		return response.json();
 	}
+	/** Create an empty dataset. */
+	async create(name) {
+		const response = await fetch(this.baseHttpUrl + this.apiPrefix + "/datasets", {
+			method: "POST",
+			headers: this.headers(),
+			body: JSON.stringify({ name })
+		});
+		if (!response.ok) await this.handleError(response);
+		return response.json();
+	}
+	/** Get a dataset by its canonical UUID. */
+	async getById(datasetId) {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/datasets/${datasetId}`, {
+			method: "GET",
+			headers: this.headers()
+		});
+		if (!response.ok) await this.handleError(response);
+		return response.json();
+	}
+	/** Rename a dataset. */
+	async update(datasetId, name) {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/datasets/${datasetId}`, {
+			method: "PATCH",
+			headers: this.headers(),
+			body: JSON.stringify({ name })
+		});
+		if (!response.ok) await this.handleError(response);
+		return response.json();
+	}
+	/** Delete a dataset and its datapoints. */
+	async delete(datasetId) {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/datasets/${datasetId}`, {
+			method: "DELETE",
+			headers: this.headers()
+		});
+		if (!response.ok) await this.handleError(response);
+		return response.json();
+	}
 	/**
 	* Get a dataset by name.
 	*
@@ -560,6 +598,66 @@ var EvaluatorsResource = class extends BaseResource {
 	}
 };
 //#endregion
+//#region src/resources/llm-profiles.ts
+/**
+* Workspace LLM profile CRUD over the CLI user-token surface
+* (`/v1/cli/llm-profiles`). Validation is entirely server-side; error messages
+* come back user-ready. Self-hosted only: on Laminar Cloud every route 404s
+* with `{error: "LLM profiles are not available on this deployment"}`.
+*/
+var LlmProfilesResource = class extends BaseResource {
+	constructor(baseHttpUrl, auth) {
+		super(baseHttpUrl, auth);
+	}
+	/**
+	* Errors come back as `{error: string}` (matches the signals surface) with
+	* user-facing text, so unwrap the envelope before raising rather than
+	* showing the raw JSON body.
+	*/
+	async raiseLlmProfileError(response) {
+		const body = await response.text();
+		let message = body;
+		try {
+			const parsed = JSON.parse(body);
+			if (typeof parsed?.error === "string" && parsed.error.length > 0) message = parsed.error;
+		} catch {}
+		throw new Error(`${response.status} ${message}`);
+	}
+	async request(method, path, body) {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/llm-profiles${path}`, {
+			method,
+			headers: this.headers(),
+			...body !== void 0 ? { body: JSON.stringify(body) } : {}
+		});
+		if (!response.ok) await this.raiseLlmProfileError(response);
+		return response;
+	}
+	/**
+	* Every workspace LLM profile visible to the caller, ordered
+	* case-insensitively by name. Empty array on a workspace with no profiles.
+	*/
+	async list() {
+		const body = await (await this.request("GET", "")).json();
+		return Array.isArray(body?.llmProfiles) ? body.llmProfiles : [];
+	}
+	async get(profileId) {
+		return (await this.request("GET", `/${profileId}`)).json();
+	}
+	async create(options) {
+		return (await this.request("POST", "", options)).json();
+	}
+	async update(profileId, options) {
+		return (await this.request("PATCH", `/${profileId}`, options)).json();
+	}
+	/**
+	* Deletes the profile and returns it. The server refuses (409) when any
+	* signal still routes through the profile.
+	*/
+	async delete(profileId) {
+		return (await this.request("DELETE", `/${profileId}`)).json();
+	}
+};
+//#endregion
 //#region src/resources/rollout-sessions.ts
 const logger$1 = initializeLogger();
 /**
@@ -790,6 +888,21 @@ var SignalsResource = class extends BaseResource {
 		if (!response.ok) await this.raiseSignalError(response);
 		return response.json();
 	}
+	/**
+	* Historical judge definitions for `signalId`, oldest first. Distinct from
+	* `GET /signals/{id}`'s `version` field, which is only the current pointer.
+	* 404 if that id isn't in this project; an empty list only if the signal
+	* exists with no version rows.
+	*/
+	async listVersions(signalId) {
+		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/signals/${signalId}/versions`, {
+			method: "GET",
+			headers: this.headers()
+		});
+		if (!response.ok) await this.raiseSignalError(response);
+		const body = await response.json();
+		return Array.isArray(body?.versions) ? body.versions : [];
+	}
 	async create(options) {
 		const response = await fetch(`${this.baseHttpUrl}${this.apiPrefix}/signals`, {
 			method: "POST",
@@ -900,8 +1013,8 @@ var TagsResource = class extends BaseResource {
 		const formattedTraceId = isStringUUID(trace_id) ? trace_id : otelTraceIdToUUID(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",
@@ -1008,6 +1121,7 @@ var LaminarClient = class LaminarClient {
 		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._llmProfiles = new LlmProfilesResource(this.baseUrl, this.auth);
 		this._rolloutSessions = new RolloutSessionsResource(this.baseUrl, this.auth);
 		this._signals = new SignalsResource(this.baseUrl, this.auth);
 		this._sql = new SqlResource(this.baseUrl, this.auth);
@@ -1078,6 +1192,9 @@ var LaminarClient = class LaminarClient {
 	get evaluators() {
 		return this._evaluators;
 	}
+	get llmProfiles() {
+		return this._llmProfiles;
+	}
 	get signals() {
 		return this._signals;
 	}