@lmnr-ai/types 0.8.29 → 0.8.31

package/dist/index.cjs

@@ -1,4 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/debug-session.ts
+/** Directory the debug-session file lives in, relative to the working dir. */
+const DEBUG_SESSION_DIR = ".lmnr";
+/** Filename of the debug-session file inside {@link DEBUG_SESSION_DIR}. */
+const DEBUG_SESSION_FILE = "debug-session.json";
+//#endregion
 //#region src/tracing.ts
 /**
 * Tracing levels to conditionally disable tracing.
@@ -17,6 +23,8 @@ let TracingLevel = /* @__PURE__ */ function(TracingLevel) {
 //#region src/utils.ts
 const errorMessage = (error) => error instanceof Error ? error.message : String(error);
 //#endregion
+exports.DEBUG_SESSION_DIR = DEBUG_SESSION_DIR;
+exports.DEBUG_SESSION_FILE = DEBUG_SESSION_FILE;
 exports.TracingLevel = TracingLevel;
 exports.errorMessage = errorMessage;
 

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 * 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"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/debug-session.ts","../src/tracing.ts","../src/utils.ts"],"sourcesContent":["/**\n * Shared `.lmnr/debug-session.json` contract.\n *\n * Single source of truth for the persisted debug-session record's SHAPE and\n * location, imported by both `@lmnr-ai/lmnr` (the SDK — reads at init, writes at\n * shutdown) and `lmnr-cli` (resets it via `debug session new`). `@lmnr-ai/types`\n * stays type-only (no `node:fs`), so the fs read/write helpers live in each\n * consumer; they all import this interface + the filename consts, which is what\n * keeps the on-disk shape from drifting between writers.\n */\n\n/**\n * Persisted debug-session record at `${CWD}/.lmnr/debug-session.json`.\n *\n * Replaces the old `.lmnr/last-run.json` pointer; it is the default persistence\n * for a debug run (no opt-in env var). `session_id` is the PRIMARY field read at\n * startup to decide \"join existing session vs. mint a new one\".\n */\nexport interface DebugSessionFile {\n  /** Current debug session id (UUID). The thing read at startup. Required. */\n  session_id: string;\n  /** Root trace id produced by the most recent run in this session, or null. */\n  trace_id: string | null;\n  /** Replay-source trace id, or null. */\n  replay_trace_id: string | null;\n  /** Span-id needle bounding the replay window, or null. Verbatim. */\n  cache_until: string | null;\n  /** Full per-session debugger URL, or null until known. */\n  debugger_url: string | null;\n  /** ISO-8601 timestamp this session was created/started. */\n  started_at: string;\n}\n\n/** Directory the debug-session file lives in, relative to the working dir. */\nexport const DEBUG_SESSION_DIR = \".lmnr\";\n/** Filename of the debug-session file inside {@link DEBUG_SESSION_DIR}. */\nexport const DEBUG_SESSION_FILE = \"debug-session.json\";\n","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":";;;AAkCA,MAAa,oBAAoB;;AAEjC,MAAa,qBAAqB;;;;;;;;;;ACJlC,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

@@ -29,19 +29,43 @@ interface CachedSpan {
   output: string;
   attributes: Record<string, any>;
 }
+//#endregion
+//#region src/debug-session.d.ts
 /**
- * The debug-run pointer (§5). Emitted once at process shutdown as a console line
- * and to `${CWD}/.lmnr/last-run.json`. Key order is part of the cross-language
- * parity contract with the Python SDK.
+ * Shared `.lmnr/debug-session.json` contract.
+ *
+ * Single source of truth for the persisted debug-session record's SHAPE and
+ * location, imported by both `@lmnr-ai/lmnr` (the SDK — reads at init, writes at
+ * shutdown) and `lmnr-cli` (resets it via `debug session new`). `@lmnr-ai/types`
+ * stays type-only (no `node:fs`), so the fs read/write helpers live in each
+ * consumer; they all import this interface + the filename consts, which is what
+ * keeps the on-disk shape from drifting between writers.
+ */
+/**
+ * Persisted debug-session record at `${CWD}/.lmnr/debug-session.json`.
+ *
+ * Replaces the old `.lmnr/last-run.json` pointer; it is the default persistence
+ * for a debug run (no opt-in env var). `session_id` is the PRIMARY field read at
+ * startup to decide "join existing session vs. mint a new one".
  */
-interface DebugRunPointer {
-  trace_id: string;
+interface DebugSessionFile {
+  /** Current debug session id (UUID). The thing read at startup. Required. */
   session_id: string;
+  /** Root trace id produced by the most recent run in this session, or null. */
+  trace_id: string | null;
+  /** Replay-source trace id, or null. */
   replay_trace_id: string | null;
+  /** Span-id needle bounding the replay window, or null. Verbatim. */
   cache_until: string | null;
+  /** Full per-session debugger URL, or null until known. */
   debugger_url: string | null;
+  /** ISO-8601 timestamp this session was created/started. */
   started_at: string;
 }
+/** Directory the debug-session file lives in, relative to the working dir. */
+declare const DEBUG_SESSION_DIR = ".lmnr";
+/** Filename of the debug-session file inside {@link DEBUG_SESSION_DIR}. */
+declare const DEBUG_SESSION_FILE = "debug-session.json";
 //#endregion
 //#region src/utils.d.ts
 type StringUUID = `${string}-${string}-${string}-${string}-${string}`;
@@ -317,5 +341,5 @@ type Event = {
   value: number | string | null;
 };
 //#endregion
-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 };
+export { CachedSpan, DEBUG_SESSION_DIR, DEBUG_SESSION_FILE, Datapoint, Dataset, DebugContext, DebugSessionFile, 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

@@ -29,19 +29,43 @@ interface CachedSpan {
   output: string;
   attributes: Record<string, any>;
 }
+//#endregion
+//#region src/debug-session.d.ts
 /**
- * The debug-run pointer (§5). Emitted once at process shutdown as a console line
- * and to `${CWD}/.lmnr/last-run.json`. Key order is part of the cross-language
- * parity contract with the Python SDK.
+ * Shared `.lmnr/debug-session.json` contract.
+ *
+ * Single source of truth for the persisted debug-session record's SHAPE and
+ * location, imported by both `@lmnr-ai/lmnr` (the SDK — reads at init, writes at
+ * shutdown) and `lmnr-cli` (resets it via `debug session new`). `@lmnr-ai/types`
+ * stays type-only (no `node:fs`), so the fs read/write helpers live in each
+ * consumer; they all import this interface + the filename consts, which is what
+ * keeps the on-disk shape from drifting between writers.
+ */
+/**
+ * Persisted debug-session record at `${CWD}/.lmnr/debug-session.json`.
+ *
+ * Replaces the old `.lmnr/last-run.json` pointer; it is the default persistence
+ * for a debug run (no opt-in env var). `session_id` is the PRIMARY field read at
+ * startup to decide "join existing session vs. mint a new one".
  */
-interface DebugRunPointer {
-  trace_id: string;
+interface DebugSessionFile {
+  /** Current debug session id (UUID). The thing read at startup. Required. */
   session_id: string;
+  /** Root trace id produced by the most recent run in this session, or null. */
+  trace_id: string | null;
+  /** Replay-source trace id, or null. */
   replay_trace_id: string | null;
+  /** Span-id needle bounding the replay window, or null. Verbatim. */
   cache_until: string | null;
+  /** Full per-session debugger URL, or null until known. */
   debugger_url: string | null;
+  /** ISO-8601 timestamp this session was created/started. */
   started_at: string;
 }
+/** Directory the debug-session file lives in, relative to the working dir. */
+declare const DEBUG_SESSION_DIR = ".lmnr";
+/** Filename of the debug-session file inside {@link DEBUG_SESSION_DIR}. */
+declare const DEBUG_SESSION_FILE = "debug-session.json";
 //#endregion
 //#region src/utils.d.ts
 type StringUUID = `${string}-${string}-${string}-${string}-${string}`;
@@ -317,5 +341,5 @@ type Event = {
   value: number | string | null;
 };
 //#endregion
-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 };
+export { CachedSpan, DEBUG_SESSION_DIR, DEBUG_SESSION_FILE, Datapoint, Dataset, DebugContext, DebugSessionFile, 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

@@ -1,3 +1,9 @@
+//#region src/debug-session.ts
+/** Directory the debug-session file lives in, relative to the working dir. */
+const DEBUG_SESSION_DIR = ".lmnr";
+/** Filename of the debug-session file inside {@link DEBUG_SESSION_DIR}. */
+const DEBUG_SESSION_FILE = "debug-session.json";
+//#endregion
 //#region src/tracing.ts
 /**
 * Tracing levels to conditionally disable tracing.
@@ -16,6 +22,6 @@ let TracingLevel = /* @__PURE__ */ function(TracingLevel) {
 //#region src/utils.ts
 const errorMessage = (error) => error instanceof Error ? error.message : String(error);
 //#endregion
-export { TracingLevel, errorMessage };
+export { DEBUG_SESSION_DIR, DEBUG_SESSION_FILE, TracingLevel, errorMessage };
 
 //# sourceMappingURL=index.mjs.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 * 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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/debug-session.ts","../src/tracing.ts","../src/utils.ts"],"sourcesContent":["/**\n * Shared `.lmnr/debug-session.json` contract.\n *\n * Single source of truth for the persisted debug-session record's SHAPE and\n * location, imported by both `@lmnr-ai/lmnr` (the SDK — reads at init, writes at\n * shutdown) and `lmnr-cli` (resets it via `debug session new`). `@lmnr-ai/types`\n * stays type-only (no `node:fs`), so the fs read/write helpers live in each\n * consumer; they all import this interface + the filename consts, which is what\n * keeps the on-disk shape from drifting between writers.\n */\n\n/**\n * Persisted debug-session record at `${CWD}/.lmnr/debug-session.json`.\n *\n * Replaces the old `.lmnr/last-run.json` pointer; it is the default persistence\n * for a debug run (no opt-in env var). `session_id` is the PRIMARY field read at\n * startup to decide \"join existing session vs. mint a new one\".\n */\nexport interface DebugSessionFile {\n  /** Current debug session id (UUID). The thing read at startup. Required. */\n  session_id: string;\n  /** Root trace id produced by the most recent run in this session, or null. */\n  trace_id: string | null;\n  /** Replay-source trace id, or null. */\n  replay_trace_id: string | null;\n  /** Span-id needle bounding the replay window, or null. Verbatim. */\n  cache_until: string | null;\n  /** Full per-session debugger URL, or null until known. */\n  debugger_url: string | null;\n  /** ISO-8601 timestamp this session was created/started. */\n  started_at: string;\n}\n\n/** Directory the debug-session file lives in, relative to the working dir. */\nexport const DEBUG_SESSION_DIR = \".lmnr\";\n/** Filename of the debug-session file inside {@link DEBUG_SESSION_DIR}. */\nexport const DEBUG_SESSION_FILE = \"debug-session.json\";\n","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":";;AAkCA,MAAa,oBAAoB;;AAEjC,MAAa,qBAAqB;;;;;;;;;;ACJlC,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.29",
+  "version": "0.8.31",
   "description": "Shared types for Laminar AI SDK",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",