Enhance function tool schemas with Annotated types

- Replaced plain type hints with Annotated to provide parameter descriptions
- Marked dependencies as Optional[list[str]] for flexibility
- Improved function docstrings for consistency and clarity
- No changes to streaming logic, only schema/metadata enhancements

Author: MuhammadHassaanArain

examples/basic/stream_function_call_args.py

@@ -1,20 +1,20 @@
 import asyncio
-from typing import Any
+from typing import Any, Annotated,Optional
 
 from openai.types.responses import ResponseFunctionCallArgumentsDeltaEvent
 
 from agents import Agent, Runner, function_tool
 
 
 @function_tool
-def write_file(filename: str, content: str) -> str:
+def write_file(filename:Annotated[str,"Name of the file"], content: str) -> str:
     """Write content to a file."""
     return f"File {filename} written successfully"
 
 
 @function_tool
-def create_config(project_name: str, version: str, dependencies: list[str]) -> str:
-    """Create a configuration file for a project."""
+def create_config(project_name:Annotated[str,"Project name"], version:Annotated[str,"Project version"], dependencies: Annotated[Optional[list[str]],"Dependencies (list of packages)"]) -> str:
+    """Generate a project configuration file."""
     return f"Config for {project_name} v{version} created"