Python: [BREAKING] Replace Hosted*Tool classes with tool methods (#3634)

* Replace Hosted*Tool classes with client static factory methods

* fixed failing test

* mypy fix

* mypy fix 2

* declarative mypy fix

* addressed comments

* ToolProtocol removal

* fixed test

* agents mypy fix

* fix failing tests

* mypy fix

* addressed comments

* fixed tests

* addressed comments + added factory method overrides for azureai v2 client

* mypy fix

* added kwargs to azureai tool methods

* fixed in test

* _sessions fix

* test fix

python/samples/getting_started/agents/anthropic/anthropic_advanced.py

@@ -2,7 +2,6 @@
 
 import asyncio
 
-from agent_framework import HostedMCPTool, HostedWebSearchTool
 from agent_framework.anthropic import AnthropicChatOptions, AnthropicClient
 
 """
@@ -17,16 +16,21 @@ This sample demonstrates using Anthropic with:
 
 async def main() -> None:
     """Example of streaming response (get results as they are generated)."""
-    agent = AnthropicClient[AnthropicChatOptions]().as_agent(
+    client = AnthropicClient[AnthropicChatOptions]()
+
+    # Create MCP tool configuration using instance method
+    mcp_tool = client.get_mcp_tool(
+        name="Microsoft_Learn_MCP",
+        url="https://learn.microsoft.com/api/mcp",
+    )
+
+    # Create web search tool configuration using instance method
+    web_search_tool = client.get_web_search_tool()
+
+    agent = client.as_agent(
         name="DocsAgent",
         instructions="You are a helpful agent for both Microsoft docs questions and general questions.",
-        tools=[
-            HostedMCPTool(
-                name="Microsoft Learn MCP",
-                url="https://learn.microsoft.com/api/mcp",
-            ),
-            HostedWebSearchTool(),
-        ],
+        tools=[mcp_tool, web_search_tool],
         default_options={
             # anthropic needs a value for the max_tokens parameter
             # we set it to 1024, but you can override like this:

python/samples/getting_started/agents/anthropic/anthropic_foundry.py

@@ -2,7 +2,6 @@
 
 import asyncio
 
-from agent_framework import HostedMCPTool, HostedWebSearchTool
 from agent_framework.anthropic import AnthropicClient
 from anthropic import AsyncAnthropicFoundry
 
@@ -28,16 +27,21 @@ To use the Foundry integration ensure you have the following environment variabl
 
 async def main() -> None:
     """Example of streaming response (get results as they are generated)."""
-    agent = AnthropicClient(anthropic_client=AsyncAnthropicFoundry()).as_agent(
+    client = AnthropicClient(anthropic_client=AsyncAnthropicFoundry())
+
+    # Create MCP tool configuration using instance method
+    mcp_tool = client.get_mcp_tool(
+        name="Microsoft_Learn_MCP",
+        url="https://learn.microsoft.com/api/mcp",
+    )
+
+    # Create web search tool configuration using instance method
+    web_search_tool = client.get_web_search_tool()
+
+    agent = client.as_agent(
         name="DocsAgent",
         instructions="You are a helpful agent for both Microsoft docs questions and general questions.",
-        tools=[
-            HostedMCPTool(
-                name="Microsoft Learn MCP",
-                url="https://learn.microsoft.com/api/mcp",
-            ),
-            HostedWebSearchTool(),
-        ],
+        tools=[mcp_tool, web_search_tool],
         default_options={
             # anthropic needs a value for the max_tokens parameter
             # we set it to 1024, but you can override like this:

python/samples/getting_started/agents/anthropic/anthropic_skills.py

@@ -4,7 +4,7 @@ import asyncio
 import logging
 from pathlib import Path
 
-from agent_framework import Content, HostedCodeInterpreterTool
+from agent_framework import Content
 from agent_framework.anthropic import AnthropicChatOptions, AnthropicClient
 
 logger = logging.getLogger(__name__)
@@ -34,7 +34,7 @@ async def main() -> None:
     agent = client.as_agent(
         name="DocsAgent",
         instructions="You are a helpful agent for creating powerpoint presentations.",
-        tools=HostedCodeInterpreterTool(),
+        tools=client.get_code_interpreter_tool(),
         default_options={
             "max_tokens": 20000,
             "thinking": {"type": "enabled", "budget_tokens": 10000},