Python: Nested HandoffBuilder Workflows

[moonbox3]

Discussed in #2999

^{Originally posted by eddieahn December 22, 2025}
I have a use case involving nested handoff workflows in the Microsoft Agent Framework:

Parent Workflow:

• Uses HandoffBuilder with enable_return_to_previous=False
• For most questions, after an agent completes its task, control should return to the coordinator
• However, for certain specific questions, the coordinator needs to hand off to a child/sub-workflow

Child/Sub Workflow:

• Should be triggered for specific question types that require a multi-step process
• Within this sub-workflow, I need enable_return_to_previous=True
• Each agent in the sub-workflow requires substantial user input
• Agents should return to each other sequentially to complete their tasks
• Only when the entire sub-workflow is complete should control return to the parent workflow's coordinator

Question:
Is there a way to achieve this nested handoff behavior using HandoffBuilder, or does this require building a fully custom workflow? If HandoffBuilder doesn't currently support this, would this be considered a viable feature enhancement?

[moonbox3]

Tracking this as it came from a discussion. We should discuss if this is something we'll support at some point.