/**
 * Debug and file logging utilities.
 *
 * This module now delegates to the structured logger in `src/lib/observability/`.
 * The public API (`debug()`, `logToFile()`, `enableDebugLogs()`) is preserved
 * for backward compatibility — existing call sites don't need to change.
 *
 * New code should use `createLogger()` from `../lib/observability` directly.
 */
export declare function getLogFilePath(): string;
/**
 * Configure the log file path and enable/disable state.
 * Call before initLogFile() to override defaults.
 */
export declare function configureLogFile(opts: {
    path?: string;
    enabled?: boolean;
}): void;
/**
 * Initialize the log file with a run header.
 * @deprecated The structured logger handles initialization via `initLogger()`.
 * Kept for backward compatibility — safe to call but may be a no-op
 * if `initLogger()` has already been called.
 */
export declare function initLogFile(): void;
/**
 * Log a message to the log file.
 * Always writes regardless of debug flag (when logging is enabled).
 * Fails silently to avoid masking errors in catch blocks.
 *
 * @deprecated Use `createLogger('my-module').debug()` or `.info()` instead.
 */
export declare function logToFile(...args: unknown[]): void;
export declare function debug(...args: unknown[]): void;
export declare function enableDebugLogs(): void;
