AgentApplication route registration improvements

[Rodrigo Brandão (rodrigobr-msft)]

This pull request introduces several improvements and refactors to the AgentApplication core logic, particularly around route selectors and handler registration, as well as minor test code cleanups and formatting. The most significant changes are the enhanced flexibility in route selectors to support lists and patterns, improvements to the handoff method's typing and decorator usability, and various test code formatting updates for clarity.

Core Logic Improvements

• Enhanced route selector logic in agent_application.py to support lists of allowed activity_type values and lists of text or regex patterns for matching, making route definitions more flexible and expressive. [1] [2]
• Refactored the handoff method in AgentApplication to support both decorator and direct-call usage with proper type annotations and overloads, improving developer ergonomics and static analysis. [1] [2]
• Fixed the handler registration in handoff to wrap the provided function and ensure the correct handler is registered with the router, not the original function.
• Added a type annotation to the activity property in TurnContext for better type checking, with a type: ignore comment to suppress mypy errors.

Test Code Formatting and Cleanup

• Reformatted test code in test_teams_agent_extension.py to use consistent argument formatting and improved readability in context creation, without changing test logic. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13]
• Removed unnecessary blank lines in several test files for style consistency. [1] [2] [3]

[Copilot]

Pull request overview

This pull request refactors AgentApplication route registration to make selectors more flexible (supporting lists/patterns) and improves handoff registration ergonomics (decorator vs direct-call) with better typing. It also adds focused routing tests and applies minor test formatting cleanups.

Changes:

• Extend route selector behavior to accept lists for activity type and message match criteria (including regex patterns).
• Refactor AgentApplication.handoff to support both decorator and direct-call usage, and adjust handler registration behavior.
• Add new routing-focused tests and apply formatting/whitespace cleanups in existing tests.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
libraries/microsoft-agents-hosting-core/microsoft_agents/hosting/core/app/agent_application.py	Adds list/pattern selector support and refactors handoff registration/typing.
libraries/microsoft-agents-hosting-core/microsoft_agents/hosting/core/turn_context.py	Adds a return type annotation for TurnContext.activity.
tests/hosting_core/app/test_agent_application_routes.py	New tests covering activity/message selectors, handoff routing, and route ordering.
tests/hosting_teams/test_teams_agent_extension.py	Test formatting-only changes for readability/consistency.
tests/hosting_core/app/proactive/test_proactive.py	Removes an unnecessary blank line.
tests/hosting_core/app/proactive/test_conversation_reference_builder.py	Removes an unnecessary blank line.
tests/hosting_core/app/proactive/test_conversation_builder.py	Removes an unnecessary blank line.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.