/**
 * Safe logging utility for MCP server context
 *
 * MCP STDIO Transport Protocol:
 * - STDOUT: Reserved for JSON-RPC messages ONLY
 * - STDERR: May be used for logging (per MCP spec)
 *
 * When in MCP server mode, all logs go to STDERR to avoid polluting STDOUT.
 * When in CLI mode, logs go to their natural destinations (stdout/stderr).
 */
export declare class Logger {
    /**
     * Check if we're in MCP server mode (checked dynamically at each call)
     */
    private static isMCPServer;
    /**
     * Log an error message
     * - MCP mode: writes to stderr (allowed by MCP spec)
     * - CLI mode: writes to stderr
     */
    static error(message: string, ...args: any[]): void;
    /**
     * Log an info message
     * - MCP mode: writes to stderr (allowed by MCP spec)
     * - CLI mode: writes to stdout
     */
    static info(message: string, ...args: any[]): void;
    /**
     * Log a warning message
     * - MCP mode: writes to stderr (allowed by MCP spec)
     * - CLI mode: writes to stderr
     */
    static warn(message: string, ...args: any[]): void;
    /**
     * Log a debug message (only when DEBUG=true)
     * - MCP mode: writes to stderr (allowed by MCP spec)
     * - CLI mode: writes to stderr
     */
    static debug(message: string, ...args: any[]): void;
}
//# sourceMappingURL=logger.d.ts.map