Update Event interface code doc

Signed-off-by: Chris Doherty <[email protected]>

internal/agent/event/event.go

@@ -7,7 +7,17 @@ import "context"
 // Name is a unique name identifying an event.
 type Name string
 
-// Event is a recordable event.
+// Event is a recordable event. Each event in the event package implements this interface. Consumers
+// should type switch the Event to the appropriate type for event handling.
+//
+// E.g.
+//
+//	switch ev.(type) {
+//	case event.ActionStarted:
+//		// Handle ActionStarted event.
+//	default:
+//		// Unsupported event.
+//	}
 type Event interface {
 	// GetName retrieves the event name.
 	GetName() Name