/** 管理 Canvas Agent 的终端与文件 Debug 日志。 */
export declare class Logger {
    readonly enabled: boolean;
    readonly filePath: string;
    private readonly logger;
    private failureLogger?;
    /** 根据命令行 Debug 参数初始化日志输出。 */
    constructor();
    /** 输出 Debug 级别日志。 */
    debug(message: string, details?: unknown): void;
    /** 输出 Info 级别日志。 */
    info(message: string, details?: unknown): void;
    /** 输出 Warn 级别日志。 */
    warn(message: string, details?: unknown): void;
    /** 输出 Error 级别日志。 */
    error(message: string, details?: unknown): void;
    /** Always persist minimal, caller-whitelisted failure metadata; no request bodies or URLs. */
    failure(message: string, details: Record<string, unknown>): void;
}
export declare const logger: Logger;