Python: Clarify request info naming and HITL event filtering

Summary

The "request info" naming is unclear, and users need better control over which events trigger HITL pauses.

Files

Context

# TODO: change name with request info / make explicit that function approval will still bubble up
# The request_info name is not clear enough
# Should we add a filter on event types to pause to ask for HITL
workflow = SequentialBuilder().participants([writer, reviewer]).with_request_info().build()

Issues:

1. "request_info" does not clearly convey its purpose (human-in-the-loop)
2. Function approval events bubble up but this is not explicit
3. No way to filter which event types trigger HITL pauses

Action Items

• Rename with_request_info() to something clearer (e.g., with_human_approval(), with_hitl())
• Document that function approval events bubble up through nested workflows
• Add event type filtering for HITL (e.g., with_hitl(event_types=[...]))