TypeScript Types

interface LaminarSpanContext {
  traceId: string; // UUID
  spanId: string;  // UUID
  isRemote: boolean;
  spanPath?: string[];
  spanIdsPath?: string[];
  userId?: string;
  sessionId?: string;
  metadata?: Record<string, any>;
  traceType?: TraceType;
  tracingLevel?: TracingLevel;
  debug?: DebugContext;
}

type DebugContext = {
  enabled: boolean;
  sessionId?: string;
  replayTraceId?: string;
  cacheUntil?: string;
};

type SessionBlockType = "trace" | "evaluation" | "text" | "command";

interface TraceBlockContent {
  traceId: string;
  note?: string | null;
}

interface EvaluationBlockContent {
  evaluationId: string;
  note?: string | null;
}

interface TextBlockContent {
  text: string;
}

interface CommandBlockContent {
  command: string;
  args: string[];
  exitCode: number;
  output?: string | null;
  stderr?: string | null;
  reasoning?: string | null;
}

type SessionBlockContent =
  | TraceBlockContent
  | EvaluationBlockContent
  | TextBlockContent
  | CommandBlockContent;

interface SessionBlock {
  id: string;
  createdAt: string; // ISO-8601
  type: string; // one of SessionBlockType for known blocks
  content: Record<string, unknown>; // narrow with the *BlockContent interfaces
}

interface Datapoint<D = Record<string, any>, T = Record<string, any>> {
  data: D;
  target?: T;
  metadata?: Record<string, any>;
  id?: string;        // UUID
  createdAt?: string; // ISO timestamp
}

class LaminarDataset<D = Record<string, any>, T = Record<string, any>> {
  constructor(name?: string, options?: { id?: string; fetchSize?: number });
}

interface SessionRecordingOptions {
  maskInputOptions?: MaskInputOptions;
}

interface MaskInputOptions {
  textarea?: boolean;
  text?: boolean;
  number?: boolean;
  select?: boolean;
  email?: boolean;
  tel?: boolean;
}