import type { Agent } from 'node:https';
/**
 * Version information about the `aws-cdk` package, as reported by the npm registry
 */
export interface NpmVersionInfo {
    /**
     * The version the `latest` dist-tag points to
     */
    readonly latestVersion: string;
    /**
     * The deprecation message of the currently running version, if it is deprecated
     */
    readonly deprecated?: string;
}
/**
 * Query the public npm registry for version information about the `aws-cdk` package.
 *
 * This deliberately queries `registry.npmjs.org` directly (rather than shelling out
 * to `npm view`, which honors the local npm configuration), so that stale metadata
 * from corporate registry mirrors or the local npm cache cannot produce bogus
 * upgrade recommendations.
 */
export declare function fetchNpmVersionInfo(currentVersion: string, agent?: Agent): Promise<NpmVersionInfo>;