export type LogLevel = "debug" | "info" | "warn" | "error"; export interface Logger { level: LogLevel; /** Changes the threshold in place (a config reload). */ setLevel(level: LogLevel): void; debug(msg: string, fields?: Record): void; info(msg: string, fields?: Record): void; warn(msg: string, fields?: Record): void; error(msg: string, fields?: Record, cause?: unknown): void; child(fields: Record): Logger; } export interface LoggerOptions { level?: LogLevel; /** `json` prints one JSON object per line (default for `serve`); `pretty` is for humans. */ format?: "json" | "pretty"; stream?: NodeJS.WritableStream; base?: Record; /** Daemon-only error observer. Fields stay local; observer failures never break logging. */ onError?: (message: string, cause?: unknown) => void; } export declare function createLogger(options?: LoggerOptions): Logger; export declare const silentLogger: Logger;