import type { Logger } from "@/logger.js";
export interface CliPackageMetadata {
    name: string;
    version: string;
}
export interface CliUpdateNotice {
    packageName: string;
    currentVersion: string;
    latestVersion: string;
    command: string;
}
export interface CliUpdateCheckOptions {
    workspace?: string;
    configDir?: string;
    fetchImpl?: typeof fetch;
    now?: Date;
    timeoutMs?: number;
    cacheTtlMs?: number;
    logger?: Pick<Logger, "debug">;
    packageMetadata?: CliPackageMetadata;
    packageJsonUrl?: URL;
}
export declare function loadCliPackageMetadata(packageJsonUrl?: URL): Promise<CliPackageMetadata | null>;
export declare function compareCliVersions(left: string, right: string): number;
export declare function resolveCliUpdateCheckCachePath(packageName: string, options?: Pick<CliUpdateCheckOptions, "workspace" | "configDir">): string;
export declare function checkForCliUpdate(options?: CliUpdateCheckOptions): Promise<CliUpdateNotice | null>;