/**
 * Debug 日志工具 — 请求/响应数据先写入内存，仅在请求报错时落盘
 *
 * 日志文件命名：logs/YYYY-MM-DD-HH.log
 * 避免正常请求产生大量磁盘 I/O，只有异常请求才记录完整输入输出。
 */
export interface RequestLogBuffer {
    /** 请求端点标识 */
    endpoint: string;
    /** 日志条目列表 */
    entries: Array<{
        time: string;
        direction: string;
        data: string;
    }>;
    /** 是否已写入磁盘 */
    flushed: boolean;
}
/**
 * 创建请求级别的日志缓冲区
 * 数据先写入内存，请求成功时丢弃，请求失败时落盘
 */
export declare function createRequestLog(endpoint: string): RequestLogBuffer;
/**
 * 向缓冲区追加一条日志
 */
export declare function appendToLog(buffer: RequestLogBuffer, direction: string, data: unknown, maxLen?: number): void;
/**
 * 将缓冲区内容写入磁盘（日志文件），并标记为已刷写
 * 仅在请求报错时调用
 *
 * @param buffer 日志缓冲区
 * @param error 触发刷写的错误信息（可选），会自动追加到日志末尾
 */
export declare function flushLog(buffer: RequestLogBuffer, error?: unknown): void;
/**
 * 丢弃缓冲区内容（请求成功时调用）
 */
export declare function clearLog(buffer: RequestLogBuffer): void;
export declare function writeDebugLog(endpoint: string, direction: 'upstream' | 'downstream' | 'error' | 'validate' | 'request' | 'response', data: unknown): void;
export declare function writeSSEDebugLog(endpoint: string, direction: 'upstream' | 'downstream' | 'error' | 'validate' | 'request' | 'response', text: string, maxLen?: number): void;
//# sourceMappingURL=debug-logger.d.ts.map