export interface PythonRuntime {
    /** Path to python executable */
    pythonPath: string;
    /** Filtered environment variables */
    env: Record<string, string | undefined>;
    /** Path to virtual environment, if detected */
    venvPath?: string;
}
/**
 * Filter environment variables to a safe allowlist for Python subprocesses.
 * Removes sensitive API keys and limits to known-safe variables.
 */
export declare function filterEnv(env: Record<string, string | undefined>): Record<string, string | undefined>;
/**
 * Detect virtual environment path from VIRTUAL_ENV or common locations.
 */
export declare function resolveVenvPath(cwd: string): string | undefined;
/**
 * Resolve Python runtime including executable path, environment, and venv detection.
 */
export declare function resolvePythonRuntime(cwd: string, baseEnv: Record<string, string | undefined>): PythonRuntime;