type LogLevel = "I" | "W" | "E";
/** Default path: `~/.gg/ggeditor.log`. */
export declare function defaultLogPath(): string;
/**
 * Initialize logger. Idempotent. Writes a session HEADER line with the
 * fields that don't change across the run, so per-line overhead stays low.
 */
export declare function initLogger(filePath?: string, meta?: {
    version?: string;
    provider?: string;
    model?: string;
    host?: string;
}): void;
/** Session ID — useful for filtering one run out of an interleaved log. */
export declare function getSessionId(): string;
/** Hot-path skip flag for callers that want to avoid building log payloads. */
export declare function isLoggerActive(): boolean;
/**
 * Write a log line. Format: `HH:MM:SS.mmm L cat msg k=v k=v`.
 *
 * Values that contain spaces or `=` are JSON-quoted; bare otherwise. Long
 * fields are truncated at MAX_FIELD_CHARS with `…(+N)` so the LLM sees the
 * prefix plus a count of elided chars (rather than a silent cliff).
 */
export declare function log(level: LogLevel, category: string, message: string, data?: Record<string, unknown>): void;
export declare const logInfo: (cat: string, msg: string, data?: Record<string, unknown>) => void;
export declare const logWarn: (cat: string, msg: string, data?: Record<string, unknown>) => void;
export declare const logError: (cat: string, msg: string, data?: Record<string, unknown>) => void;
/** Close the log fd. Safe to call multiple times. */
export declare function closeLogger(): void;
export {};
//# sourceMappingURL=logger.d.ts.map