TypeScript Types

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

interface RolloutParam {
  name: string;
  type?: string;
  required?: boolean;
  nested?: RolloutParam[];
  default?: string;
}

interface LanguageModelTextBlock {
  type: 'text';
  text: string;
}

interface LanguageModelToolDefinitionOverride {
  name: string;
  description?: string;
  parameters?: Record<string, any>;
}

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;
  };
}

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 HumanEvaluator {
  constructor(options?: { value: number; label: string }[]);
}

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;
}