@lmnr-ai/types 0.8.22 → 0.8.24

package/dist/index.cjs

@@ -14,6 +14,9 @@ let TracingLevel = /* @__PURE__ */ function(TracingLevel) {
 	return TracingLevel;
 }({});
 //#endregion
+//#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
@@ -22,5 +25,6 @@ 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/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","/**\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;AACL,cAAA,SAAA;AACA,cAAA,eAAA;AACA,cAAA,SAAA;;KACD;;;;;;ACmBD,MAAa,wBAAwB"}
+{"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;AACL,cAAA,SAAA;AACA,cAAA,eAAA;AACA,cAAA,SAAA;;KACD;;;ACjCD,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;;;;;;ACmDxD,MAAa,wBAAwB"}

package/dist/index.d.cts

@@ -19,6 +19,7 @@ interface SessionRecordingOptions {
 //#endregion
 //#region src/utils.d.ts
 type StringUUID = `${string}-${string}-${string}-${string}-${string}`;
+declare const errorMessage: (error: unknown) => string;
 //#endregion
 //#region src/evaluation.d.ts
 type InitEvaluationResponse = {
@@ -380,5 +381,5 @@ type WorkerMessage = WorkerLogMessage | WorkerErrorMessage;
  */
 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 };
+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 };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -19,6 +19,7 @@ interface SessionRecordingOptions {
 //#endregion
 //#region src/utils.d.ts
 type StringUUID = `${string}-${string}-${string}-${string}-${string}`;
+declare const errorMessage: (error: unknown) => string;
 //#endregion
 //#region src/evaluation.d.ts
 type InitEvaluationResponse = {
@@ -380,5 +381,5 @@ type WorkerMessage = WorkerLogMessage | WorkerErrorMessage;
  */
 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 };
+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 };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.mjs

@@ -13,12 +13,15 @@ let TracingLevel = /* @__PURE__ */ function(TracingLevel) {
 	return TracingLevel;
 }({});
 //#endregion
+//#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 };
+export { TracingLevel, WORKER_MESSAGE_PREFIX, errorMessage };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/tracing.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","/**\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;AACL,cAAA,SAAA;AACA,cAAA,eAAA;AACA,cAAA,SAAA;;KACD;;;;;;ACmBD,MAAa,wBAAwB"}
+{"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;AACL,cAAA,SAAA;AACA,cAAA,eAAA;AACA,cAAA,SAAA;;KACD;;;ACjCD,MAAa,gBAAgB,UAC3B,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;;;;;;ACmDxD,MAAa,wBAAwB"}

package/package.json

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