@lmnr-ai/types 0.8.27 → 0.8.29

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/tracing.ts","../src/utils.ts"],"sourcesContent":["import { type StringUUID } from \"./utils\";\n\n/**\n * Span types to categorize spans.\n *\n * LLM spans are auto-instrumented LLM spans.\n * Pipeline spans are top-level spans created by the pipeline runner.\n * Executor and evaluator spans are top-level spans added automatically when doing evaluations.\n */\nexport type SpanType =\n  | 'DEFAULT'\n  | 'LLM'\n  | 'EXECUTOR'\n  | 'EVALUATOR'\n  | 'HUMAN_EVALUATOR'\n  | 'EVALUATION'\n  | 'TOOL'\n  | 'CACHED';\n\n/**\n * Trace types to categorize traces.\n * They are used as association properties passed to all spans in a trace.\n */\nexport type TraceType = 'DEFAULT' | 'EVALUATION';\n\n/**\n * Tracing levels to conditionally disable tracing.\n *\n * OFF - No tracing is sent.\n * META_ONLY - Only metadata is sent (e.g. tokens, costs, etc.).\n * ALL - All data is sent.\n */\nexport enum TracingLevel {\n  OFF = 'off',\n  META_ONLY = 'meta_only',\n  ALL = 'all',\n}\n\n/**\n * Laminar representation of an OpenTelemetry span context.\n *\n * spanId - The ID of the span.\n * traceId - The ID of the trace.\n * isRemote - Whether the span is remote.\n * spanPath - The span path (span names) leading to this span.\n * spanIdsPath - The span IDs path leading to this span.\n */\nexport type LaminarSpanContext = {\n  spanId: StringUUID;\n  traceId: StringUUID;\n  isRemote: boolean;\n  spanPath?: string[];\n  spanIdsPath?: StringUUID[];\n  userId?: string;\n  sessionId?: string;\n  metadata?: Record<string, any>;\n  traceType?: TraceType;\n  tracingLevel?: TracingLevel;\n};\n\nexport type Event = {\n  id: StringUUID;\n  templateName: string;\n  timestamp: Date;\n  spanId: StringUUID;\n  value: number | string | null;\n};\n","// UUID type alias\nexport type StringUUID = `${string}-${string}-${string}-${string}-${string}`;\n\nexport const errorMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n"],"mappings":";;;;;;;;;AAgCA,IAAY,eAAL,yBAAA,cAAA;CACL,aAAA,SAAA;CACA,aAAA,eAAA;CACA,aAAA,SAAA;;KACD;;;ACjCD,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/tracing.ts","../src/utils.ts"],"sourcesContent":["import { type StringUUID } from \"./utils\";\n\n/**\n * Span types to categorize spans.\n *\n * LLM spans are auto-instrumented LLM spans.\n * Pipeline spans are top-level spans created by the pipeline runner.\n * Executor and evaluator spans are top-level spans added automatically when doing evaluations.\n */\nexport type SpanType =\n  | 'DEFAULT'\n  | 'LLM'\n  | 'EXECUTOR'\n  | 'EVALUATOR'\n  | 'HUMAN_EVALUATOR'\n  | 'EVALUATION'\n  | 'TOOL'\n  | 'CACHED';\n\n/**\n * Trace types to categorize traces.\n * They are used as association properties passed to all spans in a trace.\n */\nexport type TraceType = 'DEFAULT' | 'EVALUATION';\n\n/**\n * Tracing levels to conditionally disable tracing.\n *\n * OFF - No tracing is sent.\n * META_ONLY - Only metadata is sent (e.g. tokens, costs, etc.).\n * ALL - All data is sent.\n */\nexport enum TracingLevel {\n  OFF = 'off',\n  META_ONLY = 'meta_only',\n  ALL = 'all',\n}\n\n/**\n * Debugger context propagated as ONE nested block of a LaminarSpanContext.\n *\n * Carries the debug-replay v2 coordinates a downstream run needs to consult the\n * same server-side cache window as the run that produced this context. Laminar\n * is the only producer; a hand-forged or `enabled: false` block is treated as\n * absent by the consumer (behaviour is explicitly undefined).\n *\n * enabled - armed flag — only `true` blocks are ever constructed by us.\n * sessionId - the run's session id, a hyphenated UUID (undefined when absent).\n * replayTraceId - the source trace to replay, a hyphenated UUID (undefined when\n *   absent).\n * cacheUntil - the cache-window span-id needle, kept VERBATIM (hyphenated or\n *   not, full UUID or short suffix) — the server resolves it.\n */\nexport type DebugContext = {\n  enabled: boolean;\n  sessionId?: string;\n  replayTraceId?: string;\n  cacheUntil?: string;\n};\n\n/**\n * Laminar representation of an OpenTelemetry span context.\n *\n * spanId - The ID of the span.\n * traceId - The ID of the trace.\n * isRemote - Whether the span is remote.\n * spanPath - The span path (span names) leading to this span.\n * spanIdsPath - The span IDs path leading to this span.\n * debug - Propagated debugger context, if any (debug-replay v2).\n */\nexport type LaminarSpanContext = {\n  spanId: StringUUID;\n  traceId: StringUUID;\n  isRemote: boolean;\n  spanPath?: string[];\n  spanIdsPath?: StringUUID[];\n  userId?: string;\n  sessionId?: string;\n  metadata?: Record<string, any>;\n  traceType?: TraceType;\n  tracingLevel?: TracingLevel;\n  debug?: DebugContext;\n};\n\nexport type Event = {\n  id: StringUUID;\n  templateName: string;\n  timestamp: Date;\n  spanId: StringUUID;\n  value: number | string | null;\n};\n","// UUID type alias\nexport type StringUUID = `${string}-${string}-${string}-${string}-${string}`;\n\nexport const errorMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n"],"mappings":";;;;;;;;;AAgCA,IAAY,eAAL,yBAAA,cAAA;CACL,aAAA,SAAA;CACA,aAAA,eAAA;CACA,aAAA,SAAA;;KACD;;;ACjCD,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM"}

package/dist/index.d.cts

@@ -19,8 +19,9 @@ interface SessionRecordingOptions {
 //#endregion
 //#region src/debug.d.ts
 /**
- * A single cached LLM span fetched from a source trace. Shaped like the row the
- * SQL/query endpoint returns so the provider wrappers consume it unchanged.
+ * A single cached LLM response served by a debug-replay cache HIT. The provider
+ * wrappers consume `output` (a JSON string) and `attributes` to reconstruct the
+ * call result; `name`/`input` are unused by replay.
  */
 interface CachedSpan {
   name: string;
@@ -37,7 +38,7 @@ interface DebugRunPointer {
   trace_id: string;
   session_id: string;
   replay_trace_id: string | null;
-  cache_until: number;
+  cache_until: string | null;
   debugger_url: string | null;
   started_at: string;
 }
@@ -264,6 +265,27 @@ declare enum TracingLevel {
   META_ONLY = "meta_only",
   ALL = "all"
 }
+/**
+ * Debugger context propagated as ONE nested block of a LaminarSpanContext.
+ *
+ * Carries the debug-replay v2 coordinates a downstream run needs to consult the
+ * same server-side cache window as the run that produced this context. Laminar
+ * is the only producer; a hand-forged or `enabled: false` block is treated as
+ * absent by the consumer (behaviour is explicitly undefined).
+ *
+ * enabled - armed flag — only `true` blocks are ever constructed by us.
+ * sessionId - the run's session id, a hyphenated UUID (undefined when absent).
+ * replayTraceId - the source trace to replay, a hyphenated UUID (undefined when
+ *   absent).
+ * cacheUntil - the cache-window span-id needle, kept VERBATIM (hyphenated or
+ *   not, full UUID or short suffix) — the server resolves it.
+ */
+type DebugContext = {
+  enabled: boolean;
+  sessionId?: string;
+  replayTraceId?: string;
+  cacheUntil?: string;
+};
 /**
  * Laminar representation of an OpenTelemetry span context.
  *
@@ -272,6 +294,7 @@ declare enum TracingLevel {
  * isRemote - Whether the span is remote.
  * spanPath - The span path (span names) leading to this span.
  * spanIdsPath - The span IDs path leading to this span.
+ * debug - Propagated debugger context, if any (debug-replay v2).
  */
 type LaminarSpanContext = {
   spanId: StringUUID;
@@ -284,6 +307,7 @@ type LaminarSpanContext = {
   metadata?: Record<string, any>;
   traceType?: TraceType;
   tracingLevel?: TracingLevel;
+  debug?: DebugContext;
 };
 type Event = {
   id: StringUUID;
@@ -293,5 +317,5 @@ type Event = {
   value: number | string | null;
 };
 //#endregion
-export { CachedSpan, Datapoint, Dataset, DebugRunPointer, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, MaskInputOptions, PushDatapointsResponse, SemanticSearchResponse, SemanticSearchResult, SessionRecordingOptions, SpanExporter, SpanProcessor, SpanType, StringUUID, TraceType, TracingLevel, errorMessage };
+export { CachedSpan, Datapoint, Dataset, DebugContext, DebugRunPointer, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, MaskInputOptions, PushDatapointsResponse, SemanticSearchResponse, SemanticSearchResult, SessionRecordingOptions, SpanExporter, SpanProcessor, SpanType, StringUUID, TraceType, TracingLevel, errorMessage };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -19,8 +19,9 @@ interface SessionRecordingOptions {
 //#endregion
 //#region src/debug.d.ts
 /**
- * A single cached LLM span fetched from a source trace. Shaped like the row the
- * SQL/query endpoint returns so the provider wrappers consume it unchanged.
+ * A single cached LLM response served by a debug-replay cache HIT. The provider
+ * wrappers consume `output` (a JSON string) and `attributes` to reconstruct the
+ * call result; `name`/`input` are unused by replay.
  */
 interface CachedSpan {
   name: string;
@@ -37,7 +38,7 @@ interface DebugRunPointer {
   trace_id: string;
   session_id: string;
   replay_trace_id: string | null;
-  cache_until: number;
+  cache_until: string | null;
   debugger_url: string | null;
   started_at: string;
 }
@@ -264,6 +265,27 @@ declare enum TracingLevel {
   META_ONLY = "meta_only",
   ALL = "all"
 }
+/**
+ * Debugger context propagated as ONE nested block of a LaminarSpanContext.
+ *
+ * Carries the debug-replay v2 coordinates a downstream run needs to consult the
+ * same server-side cache window as the run that produced this context. Laminar
+ * is the only producer; a hand-forged or `enabled: false` block is treated as
+ * absent by the consumer (behaviour is explicitly undefined).
+ *
+ * enabled - armed flag — only `true` blocks are ever constructed by us.
+ * sessionId - the run's session id, a hyphenated UUID (undefined when absent).
+ * replayTraceId - the source trace to replay, a hyphenated UUID (undefined when
+ *   absent).
+ * cacheUntil - the cache-window span-id needle, kept VERBATIM (hyphenated or
+ *   not, full UUID or short suffix) — the server resolves it.
+ */
+type DebugContext = {
+  enabled: boolean;
+  sessionId?: string;
+  replayTraceId?: string;
+  cacheUntil?: string;
+};
 /**
  * Laminar representation of an OpenTelemetry span context.
  *
@@ -272,6 +294,7 @@ declare enum TracingLevel {
  * isRemote - Whether the span is remote.
  * spanPath - The span path (span names) leading to this span.
  * spanIdsPath - The span IDs path leading to this span.
+ * debug - Propagated debugger context, if any (debug-replay v2).
  */
 type LaminarSpanContext = {
   spanId: StringUUID;
@@ -284,6 +307,7 @@ type LaminarSpanContext = {
   metadata?: Record<string, any>;
   traceType?: TraceType;
   tracingLevel?: TracingLevel;
+  debug?: DebugContext;
 };
 type Event = {
   id: StringUUID;
@@ -293,5 +317,5 @@ type Event = {
   value: number | string | null;
 };
 //#endregion
-export { CachedSpan, Datapoint, Dataset, DebugRunPointer, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, MaskInputOptions, PushDatapointsResponse, SemanticSearchResponse, SemanticSearchResult, SessionRecordingOptions, SpanExporter, SpanProcessor, SpanType, StringUUID, TraceType, TracingLevel, errorMessage };
+export { CachedSpan, Datapoint, Dataset, DebugContext, DebugRunPointer, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, MaskInputOptions, PushDatapointsResponse, SemanticSearchResponse, SemanticSearchResult, SessionRecordingOptions, SpanExporter, SpanProcessor, SpanType, StringUUID, TraceType, TracingLevel, errorMessage };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/tracing.ts","../src/utils.ts"],"sourcesContent":["import { type StringUUID } from \"./utils\";\n\n/**\n * Span types to categorize spans.\n *\n * LLM spans are auto-instrumented LLM spans.\n * Pipeline spans are top-level spans created by the pipeline runner.\n * Executor and evaluator spans are top-level spans added automatically when doing evaluations.\n */\nexport type SpanType =\n  | 'DEFAULT'\n  | 'LLM'\n  | 'EXECUTOR'\n  | 'EVALUATOR'\n  | 'HUMAN_EVALUATOR'\n  | 'EVALUATION'\n  | 'TOOL'\n  | 'CACHED';\n\n/**\n * Trace types to categorize traces.\n * They are used as association properties passed to all spans in a trace.\n */\nexport type TraceType = 'DEFAULT' | 'EVALUATION';\n\n/**\n * Tracing levels to conditionally disable tracing.\n *\n * OFF - No tracing is sent.\n * META_ONLY - Only metadata is sent (e.g. tokens, costs, etc.).\n * ALL - All data is sent.\n */\nexport enum TracingLevel {\n  OFF = 'off',\n  META_ONLY = 'meta_only',\n  ALL = 'all',\n}\n\n/**\n * Laminar representation of an OpenTelemetry span context.\n *\n * spanId - The ID of the span.\n * traceId - The ID of the trace.\n * isRemote - Whether the span is remote.\n * spanPath - The span path (span names) leading to this span.\n * spanIdsPath - The span IDs path leading to this span.\n */\nexport type LaminarSpanContext = {\n  spanId: StringUUID;\n  traceId: StringUUID;\n  isRemote: boolean;\n  spanPath?: string[];\n  spanIdsPath?: StringUUID[];\n  userId?: string;\n  sessionId?: string;\n  metadata?: Record<string, any>;\n  traceType?: TraceType;\n  tracingLevel?: TracingLevel;\n};\n\nexport type Event = {\n  id: StringUUID;\n  templateName: string;\n  timestamp: Date;\n  spanId: StringUUID;\n  value: number | string | null;\n};\n","// UUID type alias\nexport type StringUUID = `${string}-${string}-${string}-${string}-${string}`;\n\nexport const errorMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n"],"mappings":";;;;;;;;AAgCA,IAAY,eAAL,yBAAA,cAAA;CACL,aAAA,SAAA;CACA,aAAA,eAAA;CACA,aAAA,SAAA;;KACD;;;ACjCD,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/tracing.ts","../src/utils.ts"],"sourcesContent":["import { type StringUUID } from \"./utils\";\n\n/**\n * Span types to categorize spans.\n *\n * LLM spans are auto-instrumented LLM spans.\n * Pipeline spans are top-level spans created by the pipeline runner.\n * Executor and evaluator spans are top-level spans added automatically when doing evaluations.\n */\nexport type SpanType =\n  | 'DEFAULT'\n  | 'LLM'\n  | 'EXECUTOR'\n  | 'EVALUATOR'\n  | 'HUMAN_EVALUATOR'\n  | 'EVALUATION'\n  | 'TOOL'\n  | 'CACHED';\n\n/**\n * Trace types to categorize traces.\n * They are used as association properties passed to all spans in a trace.\n */\nexport type TraceType = 'DEFAULT' | 'EVALUATION';\n\n/**\n * Tracing levels to conditionally disable tracing.\n *\n * OFF - No tracing is sent.\n * META_ONLY - Only metadata is sent (e.g. tokens, costs, etc.).\n * ALL - All data is sent.\n */\nexport enum TracingLevel {\n  OFF = 'off',\n  META_ONLY = 'meta_only',\n  ALL = 'all',\n}\n\n/**\n * Debugger context propagated as ONE nested block of a LaminarSpanContext.\n *\n * Carries the debug-replay v2 coordinates a downstream run needs to consult the\n * same server-side cache window as the run that produced this context. Laminar\n * is the only producer; a hand-forged or `enabled: false` block is treated as\n * absent by the consumer (behaviour is explicitly undefined).\n *\n * enabled - armed flag — only `true` blocks are ever constructed by us.\n * sessionId - the run's session id, a hyphenated UUID (undefined when absent).\n * replayTraceId - the source trace to replay, a hyphenated UUID (undefined when\n *   absent).\n * cacheUntil - the cache-window span-id needle, kept VERBATIM (hyphenated or\n *   not, full UUID or short suffix) — the server resolves it.\n */\nexport type DebugContext = {\n  enabled: boolean;\n  sessionId?: string;\n  replayTraceId?: string;\n  cacheUntil?: string;\n};\n\n/**\n * Laminar representation of an OpenTelemetry span context.\n *\n * spanId - The ID of the span.\n * traceId - The ID of the trace.\n * isRemote - Whether the span is remote.\n * spanPath - The span path (span names) leading to this span.\n * spanIdsPath - The span IDs path leading to this span.\n * debug - Propagated debugger context, if any (debug-replay v2).\n */\nexport type LaminarSpanContext = {\n  spanId: StringUUID;\n  traceId: StringUUID;\n  isRemote: boolean;\n  spanPath?: string[];\n  spanIdsPath?: StringUUID[];\n  userId?: string;\n  sessionId?: string;\n  metadata?: Record<string, any>;\n  traceType?: TraceType;\n  tracingLevel?: TracingLevel;\n  debug?: DebugContext;\n};\n\nexport type Event = {\n  id: StringUUID;\n  templateName: string;\n  timestamp: Date;\n  spanId: StringUUID;\n  value: number | string | null;\n};\n","// UUID type alias\nexport type StringUUID = `${string}-${string}-${string}-${string}-${string}`;\n\nexport const errorMessage = (error: unknown): string =>\n  error instanceof Error ? error.message : String(error);\n"],"mappings":";;;;;;;;AAgCA,IAAY,eAAL,yBAAA,cAAA;CACL,aAAA,SAAA;CACA,aAAA,eAAA;CACA,aAAA,SAAA;;KACD;;;ACjCD,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lmnr-ai/types",
-  "version": "0.8.27",
+  "version": "0.8.29",
   "description": "Shared types for Laminar AI SDK",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",