@lmnr-ai/types 0.8.52 → 0.8.54

package/dist/index.cjs

@@ -1,11 +1,10 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/debug-session.ts
+// 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
+// src/tracing.ts
 /**
 * Tracing levels to conditionally disable tracing.
 *
@@ -19,13 +18,15 @@ let TracingLevel = /* @__PURE__ */ function(TracingLevel) {
 	TracingLevel["ALL"] = "all";
 	return TracingLevel;
 }({});
-//#endregion
-//#region src/utils.ts
+// src/utils.ts
 const errorMessage = (error) => error instanceof Error ? error.message : String(error);
-//#endregion
+/** Whether `obj` has `key` as an own property (never an inherited one, like
+* `"constructor" in {}`). `Object.hasOwn` is ES2022. */
+const hasOwn = (obj, key) => Object.prototype.hasOwnProperty.call(obj, key);
 exports.DEBUG_SESSION_DIR = DEBUG_SESSION_DIR;
 exports.DEBUG_SESSION_FILE = DEBUG_SESSION_FILE;
 exports.TracingLevel = TracingLevel;
 exports.errorMessage = errorMessage;
+exports.hasOwn = hasOwn;
 
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"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;;AACF,EAAA,CAAA,CAAA;;;ACjCA,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK"}
+{"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\n/** Whether `obj` has `key` as an own property (never an inherited one, like\n * `\"constructor\" in {}`). `Object.hasOwn` is ES2022. */\nexport const hasOwn = (obj: object, key: PropertyKey): boolean =>\n  // biome-ignore lint/suspicious/noPrototypeBuiltins: `Object.hasOwn` is ES2022\n  Object.prototype.hasOwnProperty.call(obj, key);\n"],"mappings":";;;AAkCA,MAAa,oBAAoB;;AAEjC,MAAa,qBAAqB;;;;;;;;;ACJlC,IAAY,eAAL,yBAAA,cAAA;CACL,aAAA,SAAA;CACA,aAAA,eAAA;CACA,aAAA,SAAA;;AACF,EAAA,CAAA,CAAA;;ACjCA,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;;;AAIvD,MAAa,UAAU,KAAa,QAElC,OAAO,UAAU,eAAe,KAAK,KAAK,GAAG"}

package/dist/index.d.cts

@@ -1,4 +1,3 @@
-//#region src/browser.d.ts
 /**
  * Options for masking different types of input fields during browser session recording.
  */
@@ -16,8 +15,6 @@ export interface MaskInputOptions {
 export interface SessionRecordingOptions {
   maskInputOptions?: MaskInputOptions;
 }
-//#endregion
-//#region src/debug.d.ts
 /**
  * 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
@@ -29,8 +26,6 @@ export interface CachedSpan {
   output: string;
   attributes: Record<string, any>;
 }
-//#endregion
-//#region src/debug-session.d.ts
 /**
  * Shared `.lmnr/debug-session.json` contract.
  *
@@ -66,12 +61,11 @@ export interface DebugSessionFile {
 export declare const DEBUG_SESSION_DIR = ".lmnr";
 /** Filename of the debug-session file inside {@link DEBUG_SESSION_DIR}. */
 export declare const DEBUG_SESSION_FILE = "debug-session.json";
-//#endregion
-//#region src/utils.d.ts
 export type StringUUID = `${string}-${string}-${string}-${string}-${string}`;
 export declare const errorMessage: (error: unknown) => string;
-//#endregion
-//#region src/evaluation.d.ts
+/** Whether `obj` has `key` as an own property (never an inherited one, like
+ * `"constructor" in {}`). `Object.hasOwn` is ES2022. */
+export declare const hasOwn: (obj: object, key: PropertyKey) => boolean;
 export type InitEvaluationResponse = {
   id: StringUUID;
   createdAt: Date;
@@ -101,6 +95,8 @@ export type EvaluationDatapoint<D, T, O> = {
   scores?: Record<string, number | null>;
   traceId: string;
   index: number;
+  /** Identifies the Task (test case); every Trial of a Task shares it. */
+  taskId?: string;
   executorSpanId?: string;
   datasetLink?: EvaluationDatapointDatasetLink;
 };
@@ -108,6 +104,8 @@ export interface Datapoint<D = any, T = any> {
   data: D;
   target?: T;
   metadata?: Record<string, any>;
+  /** Stable Task id. Missing on datapoints pulled from older servers. */
+  taskId?: string;
 }
 export type GetDatapointsResponse<D, T> = {
   items: Datapoint<D, T>[];
@@ -123,8 +121,6 @@ export type SemanticSearchResult = {
 export type SemanticSearchResponse = {
   results: SemanticSearchResult[];
 };
-//#endregion
-//#region src/initialize-options.d.ts
 /**
  * OpenTelemetry SDK types (imported as needed by implementations)
  */
@@ -262,8 +258,6 @@ export interface InitializeOptions {
    */
   spanProcessor?: SpanProcessor;
 }
-//#endregion
-//#region src/llm-profiles.d.ts
 /**
  * Workspace LLM profile wire shapes (`/v1/cli/llm-profiles`, mirrored from
  * app-server's `LlmProfileResponse`). Self-hosted only; on Laminar Cloud every
@@ -322,8 +316,6 @@ export interface LlmProfile {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
-//#region src/session-block.d.ts
 /**
  * Shared contract for debugger-session blocks — an ordered list of blocks (see
  * app-server `debugger_session_blocks`), each with a `type` and type-specific
@@ -386,8 +378,6 @@ export interface SessionBlock {
   /** Type-specific payload; narrow via the `*BlockContent` interfaces. */
   content: Record<string, unknown>;
 }
-//#endregion
-//#region src/signals.d.ts
 /**
  * A signal's payload schema — the structured output the LLM must return. Every
  * field is required; enums are a string field with an `enum` array.
@@ -481,8 +471,6 @@ export interface SignalBackfillResult {
   signalId: string;
   totalTraces: number;
 }
-//#endregion
-//#region src/sql-schema.d.ts
 /**
  * Shared contract for `GET /v1/sql/schema` (and its `/v1/cli` twin) — the
  * logical tables, columns, and enums the SQL engine exposes.
@@ -520,8 +508,6 @@ export interface SqlSchema {
   tables: SqlSchemaTable[];
   enums: SqlSchemaEnum[];
 }
-//#endregion
-//#region src/tracing.d.ts
 /**
  * Span types to categorize spans.
  *
@@ -598,5 +584,4 @@ export type Event = {
   spanId: StringUUID;
   value: number | string | null;
 };
-//#endregion
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -1,4 +1,3 @@
-//#region src/browser.d.ts
 /**
  * Options for masking different types of input fields during browser session recording.
  */
@@ -16,8 +15,6 @@ export interface MaskInputOptions {
 export interface SessionRecordingOptions {
   maskInputOptions?: MaskInputOptions;
 }
-//#endregion
-//#region src/debug.d.ts
 /**
  * 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
@@ -29,8 +26,6 @@ export interface CachedSpan {
   output: string;
   attributes: Record<string, any>;
 }
-//#endregion
-//#region src/debug-session.d.ts
 /**
  * Shared `.lmnr/debug-session.json` contract.
  *
@@ -66,12 +61,11 @@ export interface DebugSessionFile {
 export declare const DEBUG_SESSION_DIR = ".lmnr";
 /** Filename of the debug-session file inside {@link DEBUG_SESSION_DIR}. */
 export declare const DEBUG_SESSION_FILE = "debug-session.json";
-//#endregion
-//#region src/utils.d.ts
 export type StringUUID = `${string}-${string}-${string}-${string}-${string}`;
 export declare const errorMessage: (error: unknown) => string;
-//#endregion
-//#region src/evaluation.d.ts
+/** Whether `obj` has `key` as an own property (never an inherited one, like
+ * `"constructor" in {}`). `Object.hasOwn` is ES2022. */
+export declare const hasOwn: (obj: object, key: PropertyKey) => boolean;
 export type InitEvaluationResponse = {
   id: StringUUID;
   createdAt: Date;
@@ -101,6 +95,8 @@ export type EvaluationDatapoint<D, T, O> = {
   scores?: Record<string, number | null>;
   traceId: string;
   index: number;
+  /** Identifies the Task (test case); every Trial of a Task shares it. */
+  taskId?: string;
   executorSpanId?: string;
   datasetLink?: EvaluationDatapointDatasetLink;
 };
@@ -108,6 +104,8 @@ export interface Datapoint<D = any, T = any> {
   data: D;
   target?: T;
   metadata?: Record<string, any>;
+  /** Stable Task id. Missing on datapoints pulled from older servers. */
+  taskId?: string;
 }
 export type GetDatapointsResponse<D, T> = {
   items: Datapoint<D, T>[];
@@ -123,8 +121,6 @@ export type SemanticSearchResult = {
 export type SemanticSearchResponse = {
   results: SemanticSearchResult[];
 };
-//#endregion
-//#region src/initialize-options.d.ts
 /**
  * OpenTelemetry SDK types (imported as needed by implementations)
  */
@@ -262,8 +258,6 @@ export interface InitializeOptions {
    */
   spanProcessor?: SpanProcessor;
 }
-//#endregion
-//#region src/llm-profiles.d.ts
 /**
  * Workspace LLM profile wire shapes (`/v1/cli/llm-profiles`, mirrored from
  * app-server's `LlmProfileResponse`). Self-hosted only; on Laminar Cloud every
@@ -322,8 +316,6 @@ export interface LlmProfile {
   createdAt: string;
   updatedAt: string;
 }
-//#endregion
-//#region src/session-block.d.ts
 /**
  * Shared contract for debugger-session blocks — an ordered list of blocks (see
  * app-server `debugger_session_blocks`), each with a `type` and type-specific
@@ -386,8 +378,6 @@ export interface SessionBlock {
   /** Type-specific payload; narrow via the `*BlockContent` interfaces. */
   content: Record<string, unknown>;
 }
-//#endregion
-//#region src/signals.d.ts
 /**
  * A signal's payload schema — the structured output the LLM must return. Every
  * field is required; enums are a string field with an `enum` array.
@@ -481,8 +471,6 @@ export interface SignalBackfillResult {
   signalId: string;
   totalTraces: number;
 }
-//#endregion
-//#region src/sql-schema.d.ts
 /**
  * Shared contract for `GET /v1/sql/schema` (and its `/v1/cli` twin) — the
  * logical tables, columns, and enums the SQL engine exposes.
@@ -520,8 +508,6 @@ export interface SqlSchema {
   tables: SqlSchemaTable[];
   enums: SqlSchemaEnum[];
 }
-//#endregion
-//#region src/tracing.d.ts
 /**
  * Span types to categorize spans.
  *
@@ -598,5 +584,4 @@ export type Event = {
   spanId: StringUUID;
   value: number | string | null;
 };
-//#endregion
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -1,10 +1,9 @@
-//#region src/debug-session.ts
+// 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
+// src/tracing.ts
 /**
 * Tracing levels to conditionally disable tracing.
 *
@@ -18,10 +17,11 @@ let TracingLevel = /* @__PURE__ */ function(TracingLevel) {
 	TracingLevel["ALL"] = "all";
 	return TracingLevel;
 }({});
-//#endregion
-//#region src/utils.ts
+// src/utils.ts
 const errorMessage = (error) => error instanceof Error ? error.message : String(error);
-//#endregion
-export { DEBUG_SESSION_DIR, DEBUG_SESSION_FILE, TracingLevel, errorMessage };
+/** Whether `obj` has `key` as an own property (never an inherited one, like
+* `"constructor" in {}`). `Object.hasOwn` is ES2022. */
+const hasOwn = (obj, key) => Object.prototype.hasOwnProperty.call(obj, key);
+export { DEBUG_SESSION_DIR, DEBUG_SESSION_FILE, TracingLevel, errorMessage, hasOwn };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"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;;AACF,EAAA,CAAA,CAAA;;;ACjCA,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK"}
+{"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\n/** Whether `obj` has `key` as an own property (never an inherited one, like\n * `\"constructor\" in {}`). `Object.hasOwn` is ES2022. */\nexport const hasOwn = (obj: object, key: PropertyKey): boolean =>\n  // biome-ignore lint/suspicious/noPrototypeBuiltins: `Object.hasOwn` is ES2022\n  Object.prototype.hasOwnProperty.call(obj, key);\n"],"mappings":";;AAkCA,MAAa,oBAAoB;;AAEjC,MAAa,qBAAqB;;;;;;;;;ACJlC,IAAY,eAAL,yBAAA,cAAA;CACL,aAAA,SAAA;CACA,aAAA,eAAA;CACA,aAAA,SAAA;;AACF,EAAA,CAAA,CAAA;;ACjCA,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;;;AAIvD,MAAa,UAAU,KAAa,QAElC,OAAO,UAAU,eAAe,KAAK,KAAK,GAAG"}

package/package.json

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