@lmnr-ai/types 0.8.26 → 0.8.28

package/dist/index.cjs

@@ -17,14 +17,7 @@ let TracingLevel = /* @__PURE__ */ function(TracingLevel) {
 //#region src/utils.ts
 const errorMessage = (error) => error instanceof Error ? error.message : String(error);
 //#endregion
-//#region src/worker-protocol.ts
-/**
-* Message prefix for protocol messages in stdout
-*/
-const WORKER_MESSAGE_PREFIX = "__LMNR_WORKER__:";
-//#endregion
 exports.TracingLevel = TracingLevel;
-exports.WORKER_MESSAGE_PREFIX = WORKER_MESSAGE_PREFIX;
 exports.errorMessage = errorMessage;
 
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/tracing.ts","../src/utils.ts","../src/worker-protocol.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  rolloutSessionId?: 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","/**\n * Worker protocol types for subprocess communication between CLI and language-specific workers.\n *\n * The protocol uses stdin/stdout for communication:\n * - Input: JSON configuration sent via stdin (single line)\n * - Output: Protocol messages prefixed with __LMNR_WORKER__: via stdout\n * - User output: Unprefixed stdout (passed through transparently)\n */\n\n/**\n * Configuration sent to worker process via stdin\n */\nexport interface WorkerConfig {\n  filePath?: string; // File path for script mode (TS/JS/Python)\n  modulePath?: string; // Module path for Python module mode (e.g., 'src.myfile')\n  functionName?: string;\n  args: Record<string, any> | any[];\n  env: Record<string, string>;\n  cacheServerPort: number;\n  baseUrl: string;\n  projectApiKey?: string;\n  httpPort: number;\n  grpcPort: number;\n  externalPackages?: string[];\n  dynamicImportsToSkip?: string[];\n}\n\n/**\n * Log message from worker to parent\n */\nexport interface WorkerLogMessage {\n  type: 'log';\n  level: 'info' | 'debug' | 'error' | 'warn';\n  message: string;\n}\n\n/**\n * Error message when function fails\n */\nexport interface WorkerErrorMessage {\n  type: 'error';\n  error: string;\n  stack?: string;\n}\n\n/**\n * Union of all worker message types\n */\nexport type WorkerMessage =\n  | WorkerLogMessage\n  | WorkerErrorMessage;\n\n/**\n * Message prefix for protocol messages in stdout\n */\nexport const WORKER_MESSAGE_PREFIX = '__LMNR_WORKER__:';\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;;;;;;ACmDxD,MAAa,wBAAwB"}
+{"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

@@ -17,6 +17,32 @@ 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
+ * call result; `name`/`input` are unused by replay.
+ */
+interface CachedSpan {
+  name: string;
+  input: string;
+  output: string;
+  attributes: Record<string, any>;
+}
+/**
+ * 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.
+ */
+interface DebugRunPointer {
+  trace_id: string;
+  session_id: string;
+  replay_trace_id: string | null;
+  cache_until: string | null;
+  debugger_url: string | null;
+  started_at: string;
+}
+//#endregion
 //#region src/utils.d.ts
 type StringUUID = `${string}-${string}-${string}-${string}-${string}`;
 declare const errorMessage: (error: unknown) => string;
@@ -213,67 +239,6 @@ interface InitializeOptions {
   spanProcessor?: SpanProcessor;
 }
 //#endregion
-//#region src/rollout.d.ts
-interface LanguageModelTextBlock {
-  type: 'text';
-  text: string;
-}
-interface LanguageModelToolDefinitionOverride {
-  name: string;
-  description?: string;
-  parameters?: Record<string, any>;
-}
-/**
- * Event payload for rollout debugging sessions run events
- */
-interface RolloutRunEvent {
-  event_type: 'run';
-  data: {
-    trace_id?: string;
-    path_to_count?: Record<string, number>;
-    args: Record<string, any> | any[];
-    overrides?: Record<string, {
-      system?: string | LanguageModelTextBlock[];
-      tools?: LanguageModelToolDefinitionOverride[];
-    }>;
-  };
-}
-interface RolloutHandshakeEvent {
-  event_type: 'handshake';
-  data: {
-    session_id: string;
-    project_id: string;
-  };
-}
-/**
- * Parameter metadata for rollout functions
- */
-interface RolloutParam {
-  name: string;
-  type?: string;
-  required?: boolean;
-  nested?: RolloutParam[];
-  default?: string;
-}
-interface CachedSpan {
-  name: string;
-  input: string;
-  output: string;
-  attributes: Record<string, any>;
-}
-interface CacheMetadata {
-  pathToCount: Record<string, number>;
-  overrides?: Record<string, {
-    system?: string | LanguageModelTextBlock[];
-    tools?: LanguageModelToolDefinitionOverride[];
-  }>;
-}
-interface CacheServerResponse {
-  pathToCount: CacheMetadata['pathToCount'];
-  overrides?: CacheMetadata['overrides'];
-  span?: CachedSpan;
-}
-//#endregion
 //#region src/tracing.d.ts
 /**
  * Span types to categorize spans.
@@ -300,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.
  *
@@ -308,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;
@@ -317,10 +304,10 @@ type LaminarSpanContext = {
   spanIdsPath?: StringUUID[];
   userId?: string;
   sessionId?: string;
-  rolloutSessionId?: string;
   metadata?: Record<string, any>;
   traceType?: TraceType;
   tracingLevel?: TracingLevel;
+  debug?: DebugContext;
 };
 type Event = {
   id: StringUUID;
@@ -330,56 +317,5 @@ type Event = {
   value: number | string | null;
 };
 //#endregion
-//#region src/worker-protocol.d.ts
-/**
- * Worker protocol types for subprocess communication between CLI and language-specific workers.
- *
- * The protocol uses stdin/stdout for communication:
- * - Input: JSON configuration sent via stdin (single line)
- * - Output: Protocol messages prefixed with __LMNR_WORKER__: via stdout
- * - User output: Unprefixed stdout (passed through transparently)
- */
-/**
- * Configuration sent to worker process via stdin
- */
-interface WorkerConfig {
-  filePath?: string;
-  modulePath?: string;
-  functionName?: string;
-  args: Record<string, any> | any[];
-  env: Record<string, string>;
-  cacheServerPort: number;
-  baseUrl: string;
-  projectApiKey?: string;
-  httpPort: number;
-  grpcPort: number;
-  externalPackages?: string[];
-  dynamicImportsToSkip?: string[];
-}
-/**
- * Log message from worker to parent
- */
-interface WorkerLogMessage {
-  type: 'log';
-  level: 'info' | 'debug' | 'error' | 'warn';
-  message: string;
-}
-/**
- * Error message when function fails
- */
-interface WorkerErrorMessage {
-  type: 'error';
-  error: string;
-  stack?: string;
-}
-/**
- * Union of all worker message types
- */
-type WorkerMessage = WorkerLogMessage | WorkerErrorMessage;
-/**
- * Message prefix for protocol messages in stdout
- */
-declare const WORKER_MESSAGE_PREFIX = "__LMNR_WORKER__:";
-//#endregion
-export { CacheMetadata, CacheServerResponse, CachedSpan, Datapoint, Dataset, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, LanguageModelTextBlock, LanguageModelToolDefinitionOverride, MaskInputOptions, PushDatapointsResponse, RolloutHandshakeEvent, RolloutParam, RolloutRunEvent, SemanticSearchResponse, SemanticSearchResult, SessionRecordingOptions, SpanExporter, SpanProcessor, SpanType, StringUUID, TraceType, TracingLevel, WORKER_MESSAGE_PREFIX, WorkerConfig, WorkerErrorMessage, WorkerLogMessage, WorkerMessage, 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

@@ -17,6 +17,32 @@ 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
+ * call result; `name`/`input` are unused by replay.
+ */
+interface CachedSpan {
+  name: string;
+  input: string;
+  output: string;
+  attributes: Record<string, any>;
+}
+/**
+ * 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.
+ */
+interface DebugRunPointer {
+  trace_id: string;
+  session_id: string;
+  replay_trace_id: string | null;
+  cache_until: string | null;
+  debugger_url: string | null;
+  started_at: string;
+}
+//#endregion
 //#region src/utils.d.ts
 type StringUUID = `${string}-${string}-${string}-${string}-${string}`;
 declare const errorMessage: (error: unknown) => string;
@@ -213,67 +239,6 @@ interface InitializeOptions {
   spanProcessor?: SpanProcessor;
 }
 //#endregion
-//#region src/rollout.d.ts
-interface LanguageModelTextBlock {
-  type: 'text';
-  text: string;
-}
-interface LanguageModelToolDefinitionOverride {
-  name: string;
-  description?: string;
-  parameters?: Record<string, any>;
-}
-/**
- * Event payload for rollout debugging sessions run events
- */
-interface RolloutRunEvent {
-  event_type: 'run';
-  data: {
-    trace_id?: string;
-    path_to_count?: Record<string, number>;
-    args: Record<string, any> | any[];
-    overrides?: Record<string, {
-      system?: string | LanguageModelTextBlock[];
-      tools?: LanguageModelToolDefinitionOverride[];
-    }>;
-  };
-}
-interface RolloutHandshakeEvent {
-  event_type: 'handshake';
-  data: {
-    session_id: string;
-    project_id: string;
-  };
-}
-/**
- * Parameter metadata for rollout functions
- */
-interface RolloutParam {
-  name: string;
-  type?: string;
-  required?: boolean;
-  nested?: RolloutParam[];
-  default?: string;
-}
-interface CachedSpan {
-  name: string;
-  input: string;
-  output: string;
-  attributes: Record<string, any>;
-}
-interface CacheMetadata {
-  pathToCount: Record<string, number>;
-  overrides?: Record<string, {
-    system?: string | LanguageModelTextBlock[];
-    tools?: LanguageModelToolDefinitionOverride[];
-  }>;
-}
-interface CacheServerResponse {
-  pathToCount: CacheMetadata['pathToCount'];
-  overrides?: CacheMetadata['overrides'];
-  span?: CachedSpan;
-}
-//#endregion
 //#region src/tracing.d.ts
 /**
  * Span types to categorize spans.
@@ -300,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.
  *
@@ -308,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;
@@ -317,10 +304,10 @@ type LaminarSpanContext = {
   spanIdsPath?: StringUUID[];
   userId?: string;
   sessionId?: string;
-  rolloutSessionId?: string;
   metadata?: Record<string, any>;
   traceType?: TraceType;
   tracingLevel?: TracingLevel;
+  debug?: DebugContext;
 };
 type Event = {
   id: StringUUID;
@@ -330,56 +317,5 @@ type Event = {
   value: number | string | null;
 };
 //#endregion
-//#region src/worker-protocol.d.ts
-/**
- * Worker protocol types for subprocess communication between CLI and language-specific workers.
- *
- * The protocol uses stdin/stdout for communication:
- * - Input: JSON configuration sent via stdin (single line)
- * - Output: Protocol messages prefixed with __LMNR_WORKER__: via stdout
- * - User output: Unprefixed stdout (passed through transparently)
- */
-/**
- * Configuration sent to worker process via stdin
- */
-interface WorkerConfig {
-  filePath?: string;
-  modulePath?: string;
-  functionName?: string;
-  args: Record<string, any> | any[];
-  env: Record<string, string>;
-  cacheServerPort: number;
-  baseUrl: string;
-  projectApiKey?: string;
-  httpPort: number;
-  grpcPort: number;
-  externalPackages?: string[];
-  dynamicImportsToSkip?: string[];
-}
-/**
- * Log message from worker to parent
- */
-interface WorkerLogMessage {
-  type: 'log';
-  level: 'info' | 'debug' | 'error' | 'warn';
-  message: string;
-}
-/**
- * Error message when function fails
- */
-interface WorkerErrorMessage {
-  type: 'error';
-  error: string;
-  stack?: string;
-}
-/**
- * Union of all worker message types
- */
-type WorkerMessage = WorkerLogMessage | WorkerErrorMessage;
-/**
- * Message prefix for protocol messages in stdout
- */
-declare const WORKER_MESSAGE_PREFIX = "__LMNR_WORKER__:";
-//#endregion
-export { CacheMetadata, CacheServerResponse, CachedSpan, Datapoint, Dataset, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, LanguageModelTextBlock, LanguageModelToolDefinitionOverride, MaskInputOptions, PushDatapointsResponse, RolloutHandshakeEvent, RolloutParam, RolloutRunEvent, SemanticSearchResponse, SemanticSearchResult, SessionRecordingOptions, SpanExporter, SpanProcessor, SpanType, StringUUID, TraceType, TracingLevel, WORKER_MESSAGE_PREFIX, WorkerConfig, WorkerErrorMessage, WorkerLogMessage, WorkerMessage, 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

@@ -16,12 +16,6 @@ let TracingLevel = /* @__PURE__ */ function(TracingLevel) {
 //#region src/utils.ts
 const errorMessage = (error) => error instanceof Error ? error.message : String(error);
 //#endregion
-//#region src/worker-protocol.ts
-/**
-* Message prefix for protocol messages in stdout
-*/
-const WORKER_MESSAGE_PREFIX = "__LMNR_WORKER__:";
-//#endregion
-export { TracingLevel, WORKER_MESSAGE_PREFIX, errorMessage };
+export { 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","../src/worker-protocol.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  rolloutSessionId?: 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","/**\n * Worker protocol types for subprocess communication between CLI and language-specific workers.\n *\n * The protocol uses stdin/stdout for communication:\n * - Input: JSON configuration sent via stdin (single line)\n * - Output: Protocol messages prefixed with __LMNR_WORKER__: via stdout\n * - User output: Unprefixed stdout (passed through transparently)\n */\n\n/**\n * Configuration sent to worker process via stdin\n */\nexport interface WorkerConfig {\n  filePath?: string; // File path for script mode (TS/JS/Python)\n  modulePath?: string; // Module path for Python module mode (e.g., 'src.myfile')\n  functionName?: string;\n  args: Record<string, any> | any[];\n  env: Record<string, string>;\n  cacheServerPort: number;\n  baseUrl: string;\n  projectApiKey?: string;\n  httpPort: number;\n  grpcPort: number;\n  externalPackages?: string[];\n  dynamicImportsToSkip?: string[];\n}\n\n/**\n * Log message from worker to parent\n */\nexport interface WorkerLogMessage {\n  type: 'log';\n  level: 'info' | 'debug' | 'error' | 'warn';\n  message: string;\n}\n\n/**\n * Error message when function fails\n */\nexport interface WorkerErrorMessage {\n  type: 'error';\n  error: string;\n  stack?: string;\n}\n\n/**\n * Union of all worker message types\n */\nexport type WorkerMessage =\n  | WorkerLogMessage\n  | WorkerErrorMessage;\n\n/**\n * Message prefix for protocol messages in stdout\n */\nexport const WORKER_MESSAGE_PREFIX = '__LMNR_WORKER__:';\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;;;;;;ACmDxD,MAAa,wBAAwB"}
+{"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.26",
+  "version": "0.8.28",
   "description": "Shared types for Laminar AI SDK",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",