/**
 * Environment File Loading
 * Loads .env files in precedence order. dotenv never overrides variables
 * that are already set, so EARLIER files win:
 *
 *   1. ./.env            (cwd — project-local config wins)
 *   2. ~/.pop/.env       (per-user CLI config)
 *   3. ~/.pop-agent/.env (agent runtime config)
 *
 * This deliberately reverses the pre-Phase-1 behavior where ~/.pop-agent/.env
 * beat the cwd .env: a human running the CLI inside a project directory now
 * gets that project's config, while agents (which run outside project dirs
 * and set HOME to their own agent home) still resolve ~/.pop-agent/.env.
 */
/**
 * Load every existing env file in precedence order (see module header).
 * Returns the absolute paths that were loaded, first = highest precedence.
 */
export declare function loadEnvFiles(): {
    loaded: string[];
};
/** Paths loaded by the last loadEnvFiles() call (for diagnostics, e.g. pop config show). */
export declare function getLoadedEnvFiles(): string[];