---
type: email
from: Ayesha Mughal <notifications@github.com>
subject: [openai/openai-agents-python] Implement bidirectional handoff system

 (#1376) (PR #1410)
received: 2026-03-05 09:55:32
date_header: Fri, 08 Aug 2025 06:52:59 -0700
priority: normal
status: awaiting_approval
uid: 26932
---

## Email Content

**From:** Ayesha Mughal <notifications@github.com>
**Subject:** [openai/openai-agents-python] Implement bidirectional handoff system

 (#1376) (PR #1410)
**Date:** Fri, 08 Aug 2025 06:52:59 -0700

### Body (preview)

Resolves #1376: Bidirectional Handoff System



This PR implements a bidirectional handoff system for orchestrator-style workflows, allowing sub-agents to return control to their parent agent. Key features:

- `AgentRegistry` and `AgentRunner` for scalable agent/workflow management

- `return_to_parent_handoff` and `create_bidirectional_handoff_workflow` for flexible workflows

- Parallel task execution via `run_parallel`

- Convenience functions (`create_financial_workflow_registry`, `create_support_workflow_registry`)

- Comprehensive test suites in `tests/test_bidirectional_handoffs.py` and `tests/test_registry_handoffs.py`

- Documentation in `docs/bidirectional_handoffs.md`, with updates to `docs/index.md`, and `README.md`



### Testing

- All tests pass (`pytest tests/test_bidirectional_handoffs.py tests/test_registry_handoffs.py -v`)

- Covers edge cases (missing agents, circular references, parallel execution)



### Checklist

- [x] Code follows SDK conventions

- [x] Tests cover all new functionality

- [x] Documentation updated

- [x] Backward compatible with existing handoffs



Please review and let me know if any changes are needed

You can view, comment on, or merge this pull request online at:



  https://github.com/openai/openai-agents-python/pull/1410



-- Commit Summary --



  * Implement bidirectional handoff system (#1376)



-- File Changes --



    A docs/bidirectional_handoffs.md (249)

    M docs/index.md (14)

    A examples/bidirectional_handoffs.py (343)

    M pyproject.toml (1)

    M src/agents/agent.py (301)

    M src/agents/handoffs.py (136)

    A src/agents/registry.py (473)

    A tests/test_bidirectional_handoffs.py (450)

    A tests/test_registry_bidirectional_handoffs.py (435)

    M uv.lock (3410)



-- Patch Links --



https://github.com/openai/openai-agents-python/pull/1410.patch

https://github.com/openai/openai-agents-python/pull/1410.diff



-- 

Reply to this email directly or view it on GitHub:

https://github.c

---

## Suggested Actions
- [ ] Reply
- [ ] Archive
- [ ] Escalate
