There is no way for a script to determine the friendship relationship between an owner and another agent. This would be useful for security orbs and other features.

Function:

Tests if the agent identified by agent_id is on the friends list of the owner of the script. Returns if the agent is a friend, otherwise . If does not identify another avatar this function returns false. One of the two agents must be on the region.