@lmnr-ai/types 0.8.44 → 0.8.46

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"],"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"}

package/dist/index.d.cts

@@ -263,6 +263,66 @@ 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
+ * route 404s with `{error: "LLM profiles are not available on this deployment"}`.
+ */
+type LlmProfileProvider = "openai_completions" | "openai_responses" | "gemini" | "bedrock" | "azure_chat_completions" | "azure_responses" | "azure_anthropic" | "custom";
+/**
+ * How the profile authenticates. `api_key` for every provider except Bedrock,
+ * which takes AWS keys (secret arrives separately in `secrets`) or a bearer
+ * token.
+ */
+type LlmProfileAuth = {
+  type: "api_key";
+} | {
+  type: "aws_keys";
+  accessKeyId: string;
+} | {
+  type: "bearer_token";
+};
+/**
+ * Non-secret provider options. The server normalizes per provider: absent
+ * fields are omitted on the wire, never `null`.
+ */
+interface LlmProfileConfig {
+  auth: LlmProfileAuth;
+  /** Bedrock. */
+  region?: string;
+  /** Azure: exactly one of `resourceId` / `baseUrl`. */
+  resourceId?: string;
+  /** Azure (alternative to `resourceId`) or `custom` (required). */
+  baseUrl?: string;
+  /** Azure. */
+  apiVersion?: string;
+  /** `custom`: header names whose values live in `secrets.headers`. */
+  headerNames?: string[];
+}
+/**
+ * What reads return instead of secrets: a `first3***last3` mask per stored
+ * value (fully starred when short) and custom header names only. Absent slots
+ * arrive as explicit `null` (the server does not omit them).
+ */
+interface LlmProfileSecretMasks {
+  apiKey?: string | null;
+  secretAccessKey?: string | null;
+  token?: string | null;
+  headers: string[];
+}
+interface LlmProfile {
+  id: string;
+  workspaceId: string;
+  name: string;
+  provider: LlmProfileProvider;
+  config: LlmProfileConfig;
+  models: string[];
+  secrets: LlmProfileSecretMasks;
+  createdAt: string;
+  updatedAt: string;
+}
+//#endregion
 //#region src/session-block.d.ts
 /**
  * Shared contract for debugger-session blocks — an ordered list of blocks (see
@@ -377,6 +437,40 @@ interface Signal {
   trigger: SignalTrigger;
   filters: SignalFilter[];
   mode: SignalMode;
+  /** Workspace LLM profile id; `null` = runs on the server's env LLM. */
+  llmProfileId: string | null;
+  /** Display name of `llmProfileId`; `null` alongside it. */
+  llmProfileName: string | null;
+  /** Model pinned within the profile; `null` alongside `llmProfileId`. */
+  model: string | null;
+}
+/**
+ * Stored version blob on `GET /signals/{id}/versions`. Schema key is
+ * `structuredOutputSchema`, not `structuredOutput` (that name is only on
+ * `GET /signals/{id}`). `trigger`/`filters` are stored Filter[] JSON
+ * (`signal_triggers.value` / `filters`), not the CLI tagged {@link SignalTrigger}.
+ */
+interface SignalDefinition {
+  name: string;
+  prompt: string;
+  structuredOutputSchema: SignalStructuredOutput;
+  trigger: SignalFilter[];
+  filters: SignalFilter[];
+  mode: SignalMode;
+  sampleRate: number | null;
+  disabled: boolean;
+  /** Both `null` = env-var routing. Cloud signals stay `null`. */
+  llmProfileId: string | null;
+  llmModel: string | null;
+}
+/**
+ * One historical judge definition. `GET /signals/{id}`'s `version` field is
+ * only the current pointer; this is the version log.
+ */
+interface SignalVersion {
+  version: number;
+  definition: SignalDefinition;
+  createdAt: string;
 }
 //#endregion
 //#region src/sql-schema.d.ts
@@ -426,12 +520,12 @@ interface SqlSchema {
  * Pipeline spans are top-level spans created by the pipeline runner.
  * Executor and evaluator spans are top-level spans added automatically when doing evaluations.
  */
-type SpanType = 'DEFAULT' | 'LLM' | 'EXECUTOR' | 'EVALUATOR' | 'HUMAN_EVALUATOR' | 'EVALUATION' | 'TOOL' | 'CACHED';
+type SpanType = "DEFAULT" | "LLM" | "EXECUTOR" | "EVALUATOR" | "HUMAN_EVALUATOR" | "EVALUATION" | "TOOL" | "CACHED";
 /**
  * Trace types to categorize traces.
  * They are used as association properties passed to all spans in a trace.
  */
-type TraceType = 'DEFAULT' | 'EVALUATION';
+type TraceType = "DEFAULT" | "EVALUATION";
 /**
  * Tracing levels to conditionally disable tracing.
  *
@@ -496,5 +590,5 @@ type Event = {
   value: number | string | null;
 };
 //#endregion
-export { CachedSpan, CommandBlockContent, DEBUG_SESSION_DIR, DEBUG_SESSION_FILE, Datapoint, Dataset, DebugContext, DebugSessionFile, EvaluationBlockContent, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, MaskInputOptions, PushDatapointsResponse, SemanticSearchResponse, SemanticSearchResult, SessionBlock, SessionBlockContent, SessionBlockType, SessionRecordingOptions, Signal, SignalFilter, SignalMode, SignalStructuredOutput, SignalTrigger, SpanExporter, SpanProcessor, SpanType, SqlSchema, SqlSchemaColumn, SqlSchemaEnum, SqlSchemaTable, StringUUID, TextBlockContent, TraceBlockContent, TraceType, TracingLevel, errorMessage };
+export { CachedSpan, CommandBlockContent, DEBUG_SESSION_DIR, DEBUG_SESSION_FILE, Datapoint, Dataset, DebugContext, DebugSessionFile, EvaluationBlockContent, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, LlmProfile, LlmProfileAuth, LlmProfileConfig, LlmProfileProvider, LlmProfileSecretMasks, MaskInputOptions, PushDatapointsResponse, SemanticSearchResponse, SemanticSearchResult, SessionBlock, SessionBlockContent, SessionBlockType, SessionRecordingOptions, Signal, SignalDefinition, SignalFilter, SignalMode, SignalStructuredOutput, SignalTrigger, SignalVersion, SpanExporter, SpanProcessor, SpanType, SqlSchema, SqlSchemaColumn, SqlSchemaEnum, SqlSchemaTable, StringUUID, TextBlockContent, TraceBlockContent, TraceType, TracingLevel, errorMessage };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.mts

@@ -263,6 +263,66 @@ 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
+ * route 404s with `{error: "LLM profiles are not available on this deployment"}`.
+ */
+type LlmProfileProvider = "openai_completions" | "openai_responses" | "gemini" | "bedrock" | "azure_chat_completions" | "azure_responses" | "azure_anthropic" | "custom";
+/**
+ * How the profile authenticates. `api_key` for every provider except Bedrock,
+ * which takes AWS keys (secret arrives separately in `secrets`) or a bearer
+ * token.
+ */
+type LlmProfileAuth = {
+  type: "api_key";
+} | {
+  type: "aws_keys";
+  accessKeyId: string;
+} | {
+  type: "bearer_token";
+};
+/**
+ * Non-secret provider options. The server normalizes per provider: absent
+ * fields are omitted on the wire, never `null`.
+ */
+interface LlmProfileConfig {
+  auth: LlmProfileAuth;
+  /** Bedrock. */
+  region?: string;
+  /** Azure: exactly one of `resourceId` / `baseUrl`. */
+  resourceId?: string;
+  /** Azure (alternative to `resourceId`) or `custom` (required). */
+  baseUrl?: string;
+  /** Azure. */
+  apiVersion?: string;
+  /** `custom`: header names whose values live in `secrets.headers`. */
+  headerNames?: string[];
+}
+/**
+ * What reads return instead of secrets: a `first3***last3` mask per stored
+ * value (fully starred when short) and custom header names only. Absent slots
+ * arrive as explicit `null` (the server does not omit them).
+ */
+interface LlmProfileSecretMasks {
+  apiKey?: string | null;
+  secretAccessKey?: string | null;
+  token?: string | null;
+  headers: string[];
+}
+interface LlmProfile {
+  id: string;
+  workspaceId: string;
+  name: string;
+  provider: LlmProfileProvider;
+  config: LlmProfileConfig;
+  models: string[];
+  secrets: LlmProfileSecretMasks;
+  createdAt: string;
+  updatedAt: string;
+}
+//#endregion
 //#region src/session-block.d.ts
 /**
  * Shared contract for debugger-session blocks — an ordered list of blocks (see
@@ -377,6 +437,40 @@ interface Signal {
   trigger: SignalTrigger;
   filters: SignalFilter[];
   mode: SignalMode;
+  /** Workspace LLM profile id; `null` = runs on the server's env LLM. */
+  llmProfileId: string | null;
+  /** Display name of `llmProfileId`; `null` alongside it. */
+  llmProfileName: string | null;
+  /** Model pinned within the profile; `null` alongside `llmProfileId`. */
+  model: string | null;
+}
+/**
+ * Stored version blob on `GET /signals/{id}/versions`. Schema key is
+ * `structuredOutputSchema`, not `structuredOutput` (that name is only on
+ * `GET /signals/{id}`). `trigger`/`filters` are stored Filter[] JSON
+ * (`signal_triggers.value` / `filters`), not the CLI tagged {@link SignalTrigger}.
+ */
+interface SignalDefinition {
+  name: string;
+  prompt: string;
+  structuredOutputSchema: SignalStructuredOutput;
+  trigger: SignalFilter[];
+  filters: SignalFilter[];
+  mode: SignalMode;
+  sampleRate: number | null;
+  disabled: boolean;
+  /** Both `null` = env-var routing. Cloud signals stay `null`. */
+  llmProfileId: string | null;
+  llmModel: string | null;
+}
+/**
+ * One historical judge definition. `GET /signals/{id}`'s `version` field is
+ * only the current pointer; this is the version log.
+ */
+interface SignalVersion {
+  version: number;
+  definition: SignalDefinition;
+  createdAt: string;
 }
 //#endregion
 //#region src/sql-schema.d.ts
@@ -426,12 +520,12 @@ interface SqlSchema {
  * Pipeline spans are top-level spans created by the pipeline runner.
  * Executor and evaluator spans are top-level spans added automatically when doing evaluations.
  */
-type SpanType = 'DEFAULT' | 'LLM' | 'EXECUTOR' | 'EVALUATOR' | 'HUMAN_EVALUATOR' | 'EVALUATION' | 'TOOL' | 'CACHED';
+type SpanType = "DEFAULT" | "LLM" | "EXECUTOR" | "EVALUATOR" | "HUMAN_EVALUATOR" | "EVALUATION" | "TOOL" | "CACHED";
 /**
  * Trace types to categorize traces.
  * They are used as association properties passed to all spans in a trace.
  */
-type TraceType = 'DEFAULT' | 'EVALUATION';
+type TraceType = "DEFAULT" | "EVALUATION";
 /**
  * Tracing levels to conditionally disable tracing.
  *
@@ -496,5 +590,5 @@ type Event = {
   value: number | string | null;
 };
 //#endregion
-export { CachedSpan, CommandBlockContent, DEBUG_SESSION_DIR, DEBUG_SESSION_FILE, Datapoint, Dataset, DebugContext, DebugSessionFile, EvaluationBlockContent, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, MaskInputOptions, PushDatapointsResponse, SemanticSearchResponse, SemanticSearchResult, SessionBlock, SessionBlockContent, SessionBlockType, SessionRecordingOptions, Signal, SignalFilter, SignalMode, SignalStructuredOutput, SignalTrigger, SpanExporter, SpanProcessor, SpanType, SqlSchema, SqlSchemaColumn, SqlSchemaEnum, SqlSchemaTable, StringUUID, TextBlockContent, TraceBlockContent, TraceType, TracingLevel, errorMessage };
+export { CachedSpan, CommandBlockContent, DEBUG_SESSION_DIR, DEBUG_SESSION_FILE, Datapoint, Dataset, DebugContext, DebugSessionFile, EvaluationBlockContent, EvaluationDatapoint, EvaluationDatapointDatasetLink, Event, GetDatapointsResponse, InitEvaluationResponse, InitializeOptions, LaminarSpanContext, LlmProfile, LlmProfileAuth, LlmProfileConfig, LlmProfileProvider, LlmProfileSecretMasks, MaskInputOptions, PushDatapointsResponse, SemanticSearchResponse, SemanticSearchResult, SessionBlock, SessionBlockContent, SessionBlockType, SessionRecordingOptions, Signal, SignalDefinition, SignalFilter, SignalMode, SignalStructuredOutput, SignalTrigger, SignalVersion, SpanExporter, SpanProcessor, SpanType, SqlSchema, SqlSchemaColumn, SqlSchemaEnum, SqlSchemaTable, StringUUID, TextBlockContent, TraceBlockContent, TraceType, TracingLevel, errorMessage };
 //# sourceMappingURL=index.d.mts.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"],"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lmnr-ai/types",
-  "version": "0.8.44",
+  "version": "0.8.46",
   "description": "Shared types for Laminar AI SDK",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -41,8 +41,6 @@
     }
   },
   "scripts": {
-    "build": "tsdown",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix"
+    "build": "tsdown"
   }
 }