kernel: event api extensions to clear events and avoid phantom events

This is variation of the PR to handle phantom events and hopefully
this get merged into the PR to land.

See-also: https://github.com/zephyrproject-rtos/zephyr/pull/89624


Signed-off-by: Charles Hardin <ckhardin@gmail.com>