@lmnr-ai/lmnr 0.8.52 → 0.8.53

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { S as TracingLevel, _ as MaskInputOptions, a as HumanEvaluator, b as SpanType, c as InitializeOptions, d as LaminarClient, f as Dataset, g as LaminarSpanContext, h as Event, i as EvaluatorFunctionReturn, l as EvaluationDataset, m as EvaluationDatapointDatasetLink, o as evaluate, p as EvaluationDatapoint, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset, v as PushDatapointsResponse, x as TraceType, y as SessionRecordingOptions } from "./evaluations-CgcBhNjN.cjs";
+import { S as TracingLevel, _ as MaskInputOptions, a as HumanEvaluator, b as SpanType, c as InitializeOptions, d as LaminarClient, f as Dataset, g as LaminarSpanContext, h as Event, i as EvaluatorFunctionReturn, l as EvaluationDataset, m as EvaluationDatapointDatasetLink, o as evaluate, p as EvaluationDatapoint, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset, v as PushDatapointsResponse, x as TraceType, y as SessionRecordingOptions } from "./evaluations-BXDpgOzM.cjs";
 import { ServerResponse } from "node:http";
 import { ReadableSpan, SpanExporter, SpanProcessor, TimedEvent } from "@opentelemetry/sdk-trace-base";
 import { AttributeValue, Attributes, Context, Exception, HrTime, Link, Span, Span as Span$1, SpanContext, SpanKind, SpanStatus, TimeInput, Tracer, TracerProvider } from "@opentelemetry/api";
@@ -10781,12 +10781,18 @@ interface LaminarSpanProcessorOptions {
    * If not provided, the `port` option will be used.
    */
   httpPort?: number;
+  /**
+   * The release of the running code, usually its git commit SHA, stamped on
+   * every span. Optional. If not provided, detected from the environment.
+   */
+  release?: string;
 }
 export declare class LaminarSpanProcessor implements SpanProcessor {
   private instance;
   private logger;
   private readonly _spanIdToPath;
   private readonly _spanIdLists;
+  private readonly release;
   /**
    * @param {object} options - The options for the Laminar span processor.
    * @param {string} options.baseUrl - The base URL of the Laminar API.
@@ -10801,6 +10807,8 @@ export declare class LaminarSpanProcessor implements SpanProcessor {
    * @param {boolean} options.forceHttp - Whether to force HTTP and use OpenTelemetry
    * HTTP/protobuf exporter.
    * Not recommended with Laminar backends.
+   * @param {string} options.release - The release of the running code, usually
+   * its git commit SHA. Detected from the environment if not provided.
    */
   constructor(options?: LaminarSpanProcessorOptions);
   forceFlush(): Promise<void>;
@@ -10924,6 +10932,7 @@ interface LaminarInitializeProps {
   metadata?: Record<string, any>;
   inheritGlobalContext?: boolean;
   spanProcessor?: SpanProcessor;
+  release?: string;
 }
 type LaminarAttributesProp = Record<(typeof LaminarAttributes)[keyof typeof LaminarAttributes], AttributeValue>;
 export declare class Laminar {
@@ -10994,26 +11003,30 @@ export declare class Laminar {
    * and you want Laminar spans to be children of the existing spans.
    * @param {SpanProcessor} props.spanProcessor - The span processor to use. If passed, some of
    * the other options will be ignored.
+   * @param {string} props.release - The release of the running code, usually its git commit
+   * SHA. Laminar groups an agent's traces into versions by release. If not specified, read
+   * from the LMNR_RELEASE environment variable, common deploy platform variables (Vercel,
+   * Render, Railway, Heroku, Cloud Run, ...), or the checked-out git commit.
    *
    * @example
    * import { Laminar } from '@lmnr-ai/lmnr';
    * import { OpenAI } from 'openai';
-   * import * as ChainsModule from "langchain/chains";
+   * import * as CallbackManagerModule from "@langchain/core/callbacks/manager";
    *
-   * // Initialize Laminar while auto-instrumenting Langchain and OpenAI modules.
+   * // Initialize Laminar while instrumenting LangChain and OpenAI modules.
    * Laminar.initialize({
    *   projectApiKey: "<LMNR_PROJECT_API_KEY>",
    *   instrumentModules: {
    *     langchain: {
-   *       chainsModule: ChainsModule
+   *       callbackManagerModule: CallbackManagerModule
    *     },
-   *     openAI: OpenAI
+   *     OpenAI: OpenAI
    *   }
    * });
    *
    * @throws {Error} - If project API key is not set
    */
-  static initialize({ projectApiKey, baseUrl, baseHttpUrl, httpPort, grpcPort, instrumentModules, disableBatch, traceExportTimeoutMillis, logLevel, maxExportBatchSize, maxExportBatchSizeBytes, flushBySize, forceHttp, sessionRecordingOptions, metadata, inheritGlobalContext, spanProcessor }?: LaminarInitializeProps): void;
+  static initialize({ projectApiKey, baseUrl, baseHttpUrl, httpPort, grpcPort, instrumentModules, disableBatch, traceExportTimeoutMillis, logLevel, maxExportBatchSize, maxExportBatchSizeBytes, flushBySize, forceHttp, sessionRecordingOptions, metadata, inheritGlobalContext, spanProcessor, release }?: LaminarInitializeProps): void;
   /**
    * Initialize Laminar context from the LMNR_SPAN_CONTEXT environment variable.
    * This allows continuing traces across process boundaries.

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { S as TracingLevel, _ as MaskInputOptions, a as HumanEvaluator, b as SpanType, c as InitializeOptions, d as LaminarClient, f as Dataset, g as LaminarSpanContext, h as Event, i as EvaluatorFunctionReturn, l as EvaluationDataset, m as EvaluationDatapointDatasetLink, o as evaluate, p as EvaluationDatapoint, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset, v as PushDatapointsResponse, x as TraceType, y as SessionRecordingOptions } from "./evaluations-GnmUSvoK.mjs";
+import { S as TracingLevel, _ as MaskInputOptions, a as HumanEvaluator, b as SpanType, c as InitializeOptions, d as LaminarClient, f as Dataset, g as LaminarSpanContext, h as Event, i as EvaluatorFunctionReturn, l as EvaluationDataset, m as EvaluationDatapointDatasetLink, o as evaluate, p as EvaluationDatapoint, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset, v as PushDatapointsResponse, x as TraceType, y as SessionRecordingOptions } from "./evaluations-BwB2JsRa.mjs";
 import { AttributeValue, Attributes, Context, Exception, HrTime, Link, Span, Span as Span$1, SpanContext, SpanKind, SpanStatus, TimeInput, Tracer, TracerProvider } from "@opentelemetry/api";
 import { Instrumentation, InstrumentationBase } from "@opentelemetry/instrumentation";
 import { ReadableSpan, SpanExporter, SpanProcessor, TimedEvent } from "@opentelemetry/sdk-trace-base";
@@ -10781,12 +10781,18 @@ interface LaminarSpanProcessorOptions {
    * If not provided, the `port` option will be used.
    */
   httpPort?: number;
+  /**
+   * The release of the running code, usually its git commit SHA, stamped on
+   * every span. Optional. If not provided, detected from the environment.
+   */
+  release?: string;
 }
 export declare class LaminarSpanProcessor implements SpanProcessor {
   private instance;
   private logger;
   private readonly _spanIdToPath;
   private readonly _spanIdLists;
+  private readonly release;
   /**
    * @param {object} options - The options for the Laminar span processor.
    * @param {string} options.baseUrl - The base URL of the Laminar API.
@@ -10801,6 +10807,8 @@ export declare class LaminarSpanProcessor implements SpanProcessor {
    * @param {boolean} options.forceHttp - Whether to force HTTP and use OpenTelemetry
    * HTTP/protobuf exporter.
    * Not recommended with Laminar backends.
+   * @param {string} options.release - The release of the running code, usually
+   * its git commit SHA. Detected from the environment if not provided.
    */
   constructor(options?: LaminarSpanProcessorOptions);
   forceFlush(): Promise<void>;
@@ -10924,6 +10932,7 @@ interface LaminarInitializeProps {
   metadata?: Record<string, any>;
   inheritGlobalContext?: boolean;
   spanProcessor?: SpanProcessor;
+  release?: string;
 }
 type LaminarAttributesProp = Record<(typeof LaminarAttributes)[keyof typeof LaminarAttributes], AttributeValue>;
 export declare class Laminar {
@@ -10994,26 +11003,30 @@ export declare class Laminar {
    * and you want Laminar spans to be children of the existing spans.
    * @param {SpanProcessor} props.spanProcessor - The span processor to use. If passed, some of
    * the other options will be ignored.
+   * @param {string} props.release - The release of the running code, usually its git commit
+   * SHA. Laminar groups an agent's traces into versions by release. If not specified, read
+   * from the LMNR_RELEASE environment variable, common deploy platform variables (Vercel,
+   * Render, Railway, Heroku, Cloud Run, ...), or the checked-out git commit.
    *
    * @example
    * import { Laminar } from '@lmnr-ai/lmnr';
    * import { OpenAI } from 'openai';
-   * import * as ChainsModule from "langchain/chains";
+   * import * as CallbackManagerModule from "@langchain/core/callbacks/manager";
    *
-   * // Initialize Laminar while auto-instrumenting Langchain and OpenAI modules.
+   * // Initialize Laminar while instrumenting LangChain and OpenAI modules.
    * Laminar.initialize({
    *   projectApiKey: "<LMNR_PROJECT_API_KEY>",
    *   instrumentModules: {
    *     langchain: {
-   *       chainsModule: ChainsModule
+   *       callbackManagerModule: CallbackManagerModule
    *     },
-   *     openAI: OpenAI
+   *     OpenAI: OpenAI
    *   }
    * });
    *
    * @throws {Error} - If project API key is not set
    */
-  static initialize({ projectApiKey, baseUrl, baseHttpUrl, httpPort, grpcPort, instrumentModules, disableBatch, traceExportTimeoutMillis, logLevel, maxExportBatchSize, maxExportBatchSizeBytes, flushBySize, forceHttp, sessionRecordingOptions, metadata, inheritGlobalContext, spanProcessor }?: LaminarInitializeProps): void;
+  static initialize({ projectApiKey, baseUrl, baseHttpUrl, httpPort, grpcPort, instrumentModules, disableBatch, traceExportTimeoutMillis, logLevel, maxExportBatchSize, maxExportBatchSizeBytes, flushBySize, forceHttp, sessionRecordingOptions, metadata, inheritGlobalContext, spanProcessor, release }?: LaminarInitializeProps): void;
   /**
    * Initialize Laminar context from the LMNR_SPAN_CONTEXT environment variable.
    * This allows continuing traces across process boundaries.