/**
 * GS2-46 — read the current debug-log ring buffer (oldest first). Returns a copy so callers
 * (e.g. the `/debug-dump` writer) can't mutate the live buffer.
 */
export declare function getDebugLogBuffer(): string[];
/**
 * Initialize debug logging based on config
 */
export declare function initDebugLogging(enabled: boolean): void;
/**
 * Log a debug message. Always pushed into the in-memory ring buffer (GS2-46); only appended to
 * the on-disk log file when debug logging is enabled.
 */
export declare function debugLog(message: string): void;
/**
 * Log multiple lines with proper formatting. Always buffered (GS2-46); delegates to `debugLog`
 * for the on-disk gating.
 */
export declare function debugLogMultiline(title: string, content: string): void;
/**
 * Log an object using Node.js inspect with reasonable depth. Always buffered (GS2-46); delegates
 * to `debugLogMultiline`/`debugLog` for the on-disk gating.
 */
export declare function debugLogObject(title: string, obj: unknown): void;
/**
 * Log error with stack trace. Always buffered (GS2-46); delegates to `debugLog` for the on-disk
 * gating.
 */
export declare function debugLogError(context: string, error: unknown): void;