/**
 * Read an env var, preferring `newName`, falling back to `oldName`.
 * Returns `undefined` when neither is set.
 *
 * On first use of the old name in the current process, prints a one-time
 * deprecation warning to stderr.
 */
export declare function readEnv(newName: string, oldName: string): string | undefined;
/**
 * Whether the old name is currently set (regardless of the new name).
 * Useful for tests that exercise deprecation paths without triggering reads.
 */
export declare function isLegacyEnvSet(oldName: string): boolean;
/**
 * Emit a one-time deprecation warning for an old env var name.
 * Subsequent calls for the same `oldName` are no-ops.
 *
 * Suppressed when AH_QUIET_DEPRECATIONS=1 (also accepts the old prefix
 * AGENT_HEALTH_QUIET_DEPRECATIONS=1) so tests and CI can stay quiet.
 */
export declare function warnDeprecated(oldName: string, newName: string): void;
/**
 * TEST-ONLY: reset the warned set so a single test process can exercise
 * multiple deprecation paths without one suppressing the next.
 */
export declare function _resetDeprecationCacheForTests(): void;
//# sourceMappingURL=envCompat.d.ts.map