Python: [BREAKING] changed AIFunction to FunctionTool and @ai_function to @tool (#3413)

* changed AIFunction to FunctionTool and @ai_function to @tool

* test and mypy fixes

* mypy fix

* switch function tool to always_require

* fix noop

* fix github copilot imports

* test fixes

* fix ollama test

* fixes for tests

* fix tests

* reverted change to always_require and extended timeout

* fix test

python/samples/getting_started/middleware/shared_state_middleware.py

@@ -7,6 +7,7 @@ from typing import Annotated
 
 from agent_framework import (
     FunctionInvocationContext,
+    tool,
 )
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
@@ -25,6 +26,8 @@ The example includes:
 This approach shows how middleware can work together by sharing state within the same class instance.
 """
 
+# NOTE: approval_mode="never_require" is for sample brevity. Use "always_require" in production; see samples/getting_started/tools/function_tool_with_approval.py and samples/getting_started/tools/function_tool_with_approval_and_threads.py.
+@tool(approval_mode="never_require")
 
 def get_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],
@@ -33,6 +36,7 @@ def get_weather(
     conditions = ["sunny", "cloudy", "rainy", "stormy"]
     return f"The weather in {location} is {conditions[randint(0, 3)]} with a high of {randint(10, 30)}°C."
 
+@tool(approval_mode="never_require")
 
 def get_time(
     timezone: Annotated[str, Field(description="The timezone to get the time for.")] = "UTC",