@lmnr-ai/lmnr 0.8.20 → 0.8.21

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { a as HumanEvaluator, c as InitializeOptions, d as LaminarClient, f as __exportAll, i as EvaluatorFunctionReturn, l as EvaluationDataset, o as evaluate, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset } from "./evaluations-D2duRqbG.cjs";
+import { a as HumanEvaluator, c as InitializeOptions, d as LaminarClient, f as __exportAll, i as EvaluatorFunctionReturn, l as EvaluationDataset, o as evaluate, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset } from "./evaluations-BJkIwpmH.cjs";
 import { a as Event, c as LaminarSpanContext, d as RolloutParam, f as SessionRecordingOptions, g as TracingLevel, h as TraceType, i as EvaluationDatapointDatasetLink, l as MaskInputOptions, n as Dataset, p as SpanType, r as EvaluationDatapoint, u as PushDatapointsResponse } from "./index-Bal29BRz.cjs";
 import { ServerResponse } from "http";
 import { ReadableSpan, SpanExporter, SpanProcessor, TimedEvent } from "@opentelemetry/sdk-trace-base";
@@ -4615,6 +4615,13 @@ declare class LaminarSpanProcessor implements SpanProcessor {
    * @param spanIdsPath - The span IDs path (array of span ID UUIDs)
    */
   setParentPathInfo(parentSpanId: string, spanPath: string[], spanIdsPath: StringUUID[]): void;
+  /**
+   * Drop cached path entries for a given span id. For exporters that stamp
+   * their own span id over the SDK-allocated one after `startSpan` has fired
+   * `onStart` — without this, `onEnd` reads the mutated id and its delete is
+   * a no-op, so the original entry leaks one pair of map entries per span.
+   */
+  dropPathInfo(spanId: string): void;
   clear(): void;
 }
 //#endregion
@@ -4635,6 +4642,7 @@ declare const LaminarAttributes: {
 declare class LaminarSpan implements Span$1, ReadableSpan {
   private _span;
   private _activated;
+  private _globalActiveContext?;
   constructor(span: Span$1, activated?: boolean);
   name: string;
   kind: SpanKind;
@@ -4661,6 +4669,7 @@ declare class LaminarSpan implements Span$1, ReadableSpan {
   setStatus(status: SpanStatus): this;
   updateName(name: string): this;
   end(endTime?: TimeInput): void;
+  setGlobalActiveContext(context: Context): void;
   set activated(activated: boolean);
   isRecording(): boolean;
   recordException(exception: Exception, time?: TimeInput): void;
@@ -4967,6 +4976,14 @@ declare class Laminar {
    * @param {string} options.userId - user ID to associate with the span.
    * @param {string} options.sessionId - session ID to associate with the span.
    * @param {Record<string, any>} options.metadata - metadata to associate with the span.
+   * @param {boolean} options.global - when true, the span is registered on a
+   * process-global context stack so that any subsequent `startSpan` /
+   * `startActiveSpan` call (including from unrelated async tasks) uses it as
+   * the parent. Use this for spans that span multiple disconnected async
+   * callbacks — e.g. the root span of an OpenAI Agents trace, where child
+   * spans are created from independent `TracingProcessor` callbacks that do
+   * not share an async context. Defaults to false; the span still activates
+   * within the current async context as usual.
    * @returns The started span.
    *
    * @example
@@ -5007,7 +5024,8 @@ declare class Laminar {
     userId,
     sessionId,
     metadata,
-    startTime
+    startTime,
+    global
   }: {
     name: string;
     input?: any;
@@ -5019,6 +5037,7 @@ declare class Laminar {
     sessionId?: string;
     metadata?: Record<string, any>;
     startTime?: TimeInput;
+    global?: boolean;
   }): Span$1;
   private static _startSpan;
   /**
@@ -11744,6 +11763,109 @@ declare function wrapLanguageModel(languageModel: LanguageModelV2): LanguageMode
  */
 declare function instrumentClaudeAgentQuery(originalQuery: any): any;
 //#endregion
+//#region src/opentelemetry-lib/instrumentation/mastra/types.d.ts
+interface MastraSpanErrorInfo {
+  message: string;
+  name?: string;
+  stack?: string;
+  details?: Record<string, unknown>;
+}
+interface MastraExportedSpan {
+  id: string;
+  traceId: string;
+  parentSpanId?: string;
+  name: string;
+  type: string;
+  startTime: Date;
+  endTime?: Date;
+  attributes?: Record<string, any>;
+  metadata?: Record<string, any>;
+  tags?: string[];
+  input?: unknown;
+  output?: unknown;
+  errorInfo?: MastraSpanErrorInfo;
+  isEvent: boolean;
+  isRootSpan: boolean;
+}
+interface MastraTracingEvent {
+  type: "span_started" | "span_updated" | "span_ended";
+  exportedSpan: MastraExportedSpan;
+}
+interface MastraExporterOptions {
+  /**
+   * Flush the underlying span processor after every span end. Useful for
+   * short-lived processes that exit before the batch processor would drain
+   * on its own.
+   */
+  realtime?: boolean;
+  /**
+   * When true (default), reparent Mastra traces under the caller's active
+   * OpenTelemetry span if one exists. This lets `observe()`-wrapped code that
+   * calls a Mastra agent produce a single unified trace instead of two
+   * disconnected ones (user's OTel trace + Mastra's own trace).
+   *
+   * Mastra does not propagate OTel context into its event bus, so without
+   * this we'd emit under Mastra's self-assigned trace id with no parent.
+   * Set to false to preserve Mastra's original trace id even when nested
+   * inside `observe()`.
+   */
+  linkToActiveContext?: boolean;
+}
+//#endregion
+//#region src/opentelemetry-lib/instrumentation/mastra/exporter.d.ts
+/**
+ * Bridges Mastra's ObservabilityExporter contract to Laminar's OTLP ingestion.
+ *
+ * Span-type mapping:
+ * - `model_step` → LLM (atomic LLM call; rendered with message history).
+ * - `tool_call`, `mcp_tool_call` → TOOL.
+ * - `model_chunk` → dropped (per-delta, noise).
+ * - everything else → DEFAULT.
+ *
+ * Tool-call reconstruction: Mastra's `extractStepInput` collapses prior tool
+ * calls/results into empty user messages on MODEL_STEP inputs, so we
+ * reconstruct the full conversation by accumulating (baseMessages → step0's
+ * assistant message → tool-result message(s) → step1's assistant message →
+ * …) using the parent MODEL_GENERATION's input and the children TOOL_CALL
+ * spans paired by arrival order with each step's declared toolCalls.
+ *
+ * For LLM spans we emit `ai.prompt.messages` (stringified AI SDK messages
+ * with tool-call / tool-result content parts) and `ai.response.text` +
+ * `ai.response.toolCalls` so Laminar's backend parser threads them into
+ * the LLM message history view.
+ */
+declare class MastraExporter {
+  readonly name = "laminar";
+  private readonly config;
+  private readonly traceMap;
+  private readonly generationStateById;
+  private readonly generationAttrsById;
+  private readonly generationIdByStepId;
+  private readonly stepIndexBySpanId;
+  private readonly liveOtelSpanByMastraId;
+  private warnedNotInitialized;
+  constructor(options?: MastraExporterOptions);
+  init(_options?: unknown): void;
+  exportTracingEvent(event: MastraTracingEvent): Promise<void>;
+  onTracingEvent(event: MastraTracingEvent): Promise<void>;
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+  private handleSpanStarted;
+  private recordSpanPath;
+  private handleSpanEnded;
+  private initGenerationState;
+  private captureReasoningChunk;
+  private updateGenerationStateOnSpanEnd;
+  private getOrCreateTraceState;
+  private startOtelSpan;
+  private warnNotInitializedOnce;
+  private buildParentContext;
+  private applyEndAttributes;
+  private buildLaminarAttributes;
+  private applyLlmAttributes;
+  private applyToolAttributes;
+}
+//#endregion
 //#region src/opentelemetry-lib/tracing/index.d.ts
 /**
  * Get the tracer provider. Returns Laminar's tracer provider if Laminar is initialized,
@@ -11811,5 +11933,5 @@ declare const initializeLaminarInstrumentations: (options?: {
   sessionRecordingOptions?: SessionRecordingOptions;
 }) => Instrumentation<_$_opentelemetry_instrumentation0.InstrumentationConfig>[];
 //#endregion
-export { type Datapoint, EvaluationDataset as Dataset, type Dataset as DatasetType, type EvaluationDatapoint, type EvaluationDatapointDatasetLink, type EvaluatorFunction, type EvaluatorFunctionReturn, type Event, HumanEvaluator, Laminar, LaminarAttributes, LaminarClient, LaminarDataset, type LaminarSpanContext, LaminarSpanProcessor, type MaskInputOptions, type PushDatapointsResponse, type SessionRecordingOptions, type Span, TracingLevel, evaluate, getTracer, getTracerProvider, initializeLaminarInstrumentations, instrumentClaudeAgentQuery, observe, observeDecorator, observeExperimentalDecorator, withTracingLevel, wrapAISDK, wrapLanguageModel };
+export { type Datapoint, EvaluationDataset as Dataset, type Dataset as DatasetType, type EvaluationDatapoint, type EvaluationDatapointDatasetLink, type EvaluatorFunction, type EvaluatorFunctionReturn, type Event, HumanEvaluator, Laminar, LaminarAttributes, LaminarClient, LaminarDataset, type LaminarSpanContext, LaminarSpanProcessor, type MaskInputOptions, MastraExporter, type MastraExporterOptions, type PushDatapointsResponse, type SessionRecordingOptions, type Span, TracingLevel, evaluate, getTracer, getTracerProvider, initializeLaminarInstrumentations, instrumentClaudeAgentQuery, observe, observeDecorator, observeExperimentalDecorator, withTracingLevel, wrapAISDK, wrapLanguageModel };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import { a as Event, c as LaminarSpanContext, d as RolloutParam, f as SessionRecordingOptions, g as TracingLevel, h as TraceType, i as EvaluationDatapointDatasetLink, l as MaskInputOptions, n as Dataset, p as SpanType, r as EvaluationDatapoint, u as PushDatapointsResponse } from "./index-DSH1z3_q.mjs";
-import { a as HumanEvaluator, c as InitializeOptions, d as LaminarClient, i as EvaluatorFunctionReturn, l as EvaluationDataset, o as evaluate, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset } from "./evaluations-DEbBIXng.mjs";
+import { a as HumanEvaluator, c as InitializeOptions, d as LaminarClient, i as EvaluatorFunctionReturn, l as EvaluationDataset, o as evaluate, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset } from "./evaluations-tqpNgp0P.mjs";
 import { AttributeValue, Attributes, Context, Exception, HrTime, Link, Span, Span as Span$1, SpanContext, SpanKind, SpanStatus, TimeInput, Tracer, TracerProvider } from "@opentelemetry/api";
 import * as _$_opentelemetry_instrumentation0 from "@opentelemetry/instrumentation";
 import { Instrumentation, InstrumentationBase } from "@opentelemetry/instrumentation";
@@ -4615,6 +4615,13 @@ declare class LaminarSpanProcessor implements SpanProcessor {
    * @param spanIdsPath - The span IDs path (array of span ID UUIDs)
    */
   setParentPathInfo(parentSpanId: string, spanPath: string[], spanIdsPath: StringUUID[]): void;
+  /**
+   * Drop cached path entries for a given span id. For exporters that stamp
+   * their own span id over the SDK-allocated one after `startSpan` has fired
+   * `onStart` — without this, `onEnd` reads the mutated id and its delete is
+   * a no-op, so the original entry leaks one pair of map entries per span.
+   */
+  dropPathInfo(spanId: string): void;
   clear(): void;
 }
 //#endregion
@@ -4635,6 +4642,7 @@ declare const LaminarAttributes: {
 declare class LaminarSpan implements Span$1, ReadableSpan {
   private _span;
   private _activated;
+  private _globalActiveContext?;
   constructor(span: Span$1, activated?: boolean);
   name: string;
   kind: SpanKind;
@@ -4661,6 +4669,7 @@ declare class LaminarSpan implements Span$1, ReadableSpan {
   setStatus(status: SpanStatus): this;
   updateName(name: string): this;
   end(endTime?: TimeInput): void;
+  setGlobalActiveContext(context: Context): void;
   set activated(activated: boolean);
   isRecording(): boolean;
   recordException(exception: Exception, time?: TimeInput): void;
@@ -4967,6 +4976,14 @@ declare class Laminar {
    * @param {string} options.userId - user ID to associate with the span.
    * @param {string} options.sessionId - session ID to associate with the span.
    * @param {Record<string, any>} options.metadata - metadata to associate with the span.
+   * @param {boolean} options.global - when true, the span is registered on a
+   * process-global context stack so that any subsequent `startSpan` /
+   * `startActiveSpan` call (including from unrelated async tasks) uses it as
+   * the parent. Use this for spans that span multiple disconnected async
+   * callbacks — e.g. the root span of an OpenAI Agents trace, where child
+   * spans are created from independent `TracingProcessor` callbacks that do
+   * not share an async context. Defaults to false; the span still activates
+   * within the current async context as usual.
    * @returns The started span.
    *
    * @example
@@ -5007,7 +5024,8 @@ declare class Laminar {
     userId,
     sessionId,
     metadata,
-    startTime
+    startTime,
+    global
   }: {
     name: string;
     input?: any;
@@ -5019,6 +5037,7 @@ declare class Laminar {
     sessionId?: string;
     metadata?: Record<string, any>;
     startTime?: TimeInput;
+    global?: boolean;
   }): Span$1;
   private static _startSpan;
   /**
@@ -11744,6 +11763,109 @@ declare function wrapLanguageModel(languageModel: LanguageModelV2): LanguageMode
  */
 declare function instrumentClaudeAgentQuery(originalQuery: any): any;
 //#endregion
+//#region src/opentelemetry-lib/instrumentation/mastra/types.d.ts
+interface MastraSpanErrorInfo {
+  message: string;
+  name?: string;
+  stack?: string;
+  details?: Record<string, unknown>;
+}
+interface MastraExportedSpan {
+  id: string;
+  traceId: string;
+  parentSpanId?: string;
+  name: string;
+  type: string;
+  startTime: Date;
+  endTime?: Date;
+  attributes?: Record<string, any>;
+  metadata?: Record<string, any>;
+  tags?: string[];
+  input?: unknown;
+  output?: unknown;
+  errorInfo?: MastraSpanErrorInfo;
+  isEvent: boolean;
+  isRootSpan: boolean;
+}
+interface MastraTracingEvent {
+  type: "span_started" | "span_updated" | "span_ended";
+  exportedSpan: MastraExportedSpan;
+}
+interface MastraExporterOptions {
+  /**
+   * Flush the underlying span processor after every span end. Useful for
+   * short-lived processes that exit before the batch processor would drain
+   * on its own.
+   */
+  realtime?: boolean;
+  /**
+   * When true (default), reparent Mastra traces under the caller's active
+   * OpenTelemetry span if one exists. This lets `observe()`-wrapped code that
+   * calls a Mastra agent produce a single unified trace instead of two
+   * disconnected ones (user's OTel trace + Mastra's own trace).
+   *
+   * Mastra does not propagate OTel context into its event bus, so without
+   * this we'd emit under Mastra's self-assigned trace id with no parent.
+   * Set to false to preserve Mastra's original trace id even when nested
+   * inside `observe()`.
+   */
+  linkToActiveContext?: boolean;
+}
+//#endregion
+//#region src/opentelemetry-lib/instrumentation/mastra/exporter.d.ts
+/**
+ * Bridges Mastra's ObservabilityExporter contract to Laminar's OTLP ingestion.
+ *
+ * Span-type mapping:
+ * - `model_step` → LLM (atomic LLM call; rendered with message history).
+ * - `tool_call`, `mcp_tool_call` → TOOL.
+ * - `model_chunk` → dropped (per-delta, noise).
+ * - everything else → DEFAULT.
+ *
+ * Tool-call reconstruction: Mastra's `extractStepInput` collapses prior tool
+ * calls/results into empty user messages on MODEL_STEP inputs, so we
+ * reconstruct the full conversation by accumulating (baseMessages → step0's
+ * assistant message → tool-result message(s) → step1's assistant message →
+ * …) using the parent MODEL_GENERATION's input and the children TOOL_CALL
+ * spans paired by arrival order with each step's declared toolCalls.
+ *
+ * For LLM spans we emit `ai.prompt.messages` (stringified AI SDK messages
+ * with tool-call / tool-result content parts) and `ai.response.text` +
+ * `ai.response.toolCalls` so Laminar's backend parser threads them into
+ * the LLM message history view.
+ */
+declare class MastraExporter {
+  readonly name = "laminar";
+  private readonly config;
+  private readonly traceMap;
+  private readonly generationStateById;
+  private readonly generationAttrsById;
+  private readonly generationIdByStepId;
+  private readonly stepIndexBySpanId;
+  private readonly liveOtelSpanByMastraId;
+  private warnedNotInitialized;
+  constructor(options?: MastraExporterOptions);
+  init(_options?: unknown): void;
+  exportTracingEvent(event: MastraTracingEvent): Promise<void>;
+  onTracingEvent(event: MastraTracingEvent): Promise<void>;
+  flush(): Promise<void>;
+  shutdown(): Promise<void>;
+  private handleSpanStarted;
+  private recordSpanPath;
+  private handleSpanEnded;
+  private initGenerationState;
+  private captureReasoningChunk;
+  private updateGenerationStateOnSpanEnd;
+  private getOrCreateTraceState;
+  private startOtelSpan;
+  private warnNotInitializedOnce;
+  private buildParentContext;
+  private applyEndAttributes;
+  private buildLaminarAttributes;
+  private applyLlmAttributes;
+  private applyToolAttributes;
+}
+//#endregion
 //#region src/opentelemetry-lib/tracing/index.d.ts
 /**
  * Get the tracer provider. Returns Laminar's tracer provider if Laminar is initialized,
@@ -11811,5 +11933,5 @@ declare const initializeLaminarInstrumentations: (options?: {
   sessionRecordingOptions?: SessionRecordingOptions;
 }) => Instrumentation<_$_opentelemetry_instrumentation0.InstrumentationConfig>[];
 //#endregion
-export { type Datapoint, EvaluationDataset as Dataset, type Dataset as DatasetType, type EvaluationDatapoint, type EvaluationDatapointDatasetLink, type EvaluatorFunction, type EvaluatorFunctionReturn, type Event, HumanEvaluator, Laminar, LaminarAttributes, LaminarClient, LaminarDataset, type LaminarSpanContext, LaminarSpanProcessor, type MaskInputOptions, type PushDatapointsResponse, type SessionRecordingOptions, type Span, TracingLevel, evaluate, getTracer, getTracerProvider, initializeLaminarInstrumentations, instrumentClaudeAgentQuery, observe, observeDecorator, observeExperimentalDecorator, withTracingLevel, wrapAISDK, wrapLanguageModel };
+export { type Datapoint, EvaluationDataset as Dataset, type Dataset as DatasetType, type EvaluationDatapoint, type EvaluationDatapointDatasetLink, type EvaluatorFunction, type EvaluatorFunctionReturn, type Event, HumanEvaluator, Laminar, LaminarAttributes, LaminarClient, LaminarDataset, type LaminarSpanContext, LaminarSpanProcessor, type MaskInputOptions, MastraExporter, type MastraExporterOptions, type PushDatapointsResponse, type SessionRecordingOptions, type Span, TracingLevel, evaluate, getTracer, getTracerProvider, initializeLaminarInstrumentations, instrumentClaudeAgentQuery, observe, observeDecorator, observeExperimentalDecorator, withTracingLevel, wrapAISDK, wrapLanguageModel };
 //# sourceMappingURL=index.d.mts.map