query_idle()  -  determine  how  many seconds an interactive player has
been idle

int query_idle( object ob );

Query how many seconds a player object (ob) has been idling.

in_edit(3), in_input(3)