Python: Add samples syntax checking with pyright (#3710)

* Add samples syntax checking with pyright

- Add pyrightconfig.samples.json with relaxed type checking but import validation
- Add samples-syntax poe task to check samples for syntax and import errors
- Add samples-syntax to check and pre-commit-check tasks
- Fix 78 sample errors:
  - Update workflow builder imports to use agent_framework_orchestrations
  - Change content type isinstance checks to content.type comparisons
  - Use Content factory methods instead of removed content type classes
  - Fix TypedDict access patterns for Annotation
  - Fix various API mismatches (normalize_messages, ChatMessage.text, role)

* fixed a bunch of samples and tweaks to pre-commit

* updated lock

* updated lock

* fixes

* added lint to samples

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_code_interpreter_file_generation.py

@@ -5,7 +5,6 @@ import os
 
 from agent_framework import (
     HostedCodeInterpreterTool,
-    HostedFileContent,
 )
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.ai.agents.aio import AgentsClient
@@ -63,7 +62,7 @@ async def main() -> None:
             for content in chunk.contents:
                 if content.type == "text":
                     print(content.text, end="", flush=True)
-                elif content.type == "hosted_file" and isinstance(content, HostedFileContent):
+                elif content.type == "hosted_file" and content.file_id:
                     file_ids.append(content.file_id)
                     print(f"\n[File generated: {content.file_id}]")
 

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_file_search.py

@@ -4,7 +4,7 @@ import asyncio
 import os
 from pathlib import Path
 
-from agent_framework import HostedFileSearchTool, HostedVectorStoreContent
+from agent_framework import Content, HostedFileSearchTool
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.ai.agents.aio import AgentsClient
 from azure.ai.agents.models import FileInfo, VectorStore
@@ -46,7 +46,7 @@ async def main() -> None:
             print(f"Created vector store, vector store ID: {vector_store.id}")
 
             # 2. Create file search tool with uploaded resources
-            file_search_tool = HostedFileSearchTool(inputs=[HostedVectorStoreContent(vector_store_id=vector_store.id)])
+            file_search_tool = HostedFileSearchTool(inputs=[Content.from_hosted_vector_store(vector_store_id=vector_store.id)])
 
             # 3. Create an agent with file search capabilities
             agent = await provider.create_agent(

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_hosted_mcp.py

@@ -3,7 +3,7 @@
 import asyncio
 from typing import Any
 
-from agent_framework import SupportsAgentRun, AgentResponse, AgentThread, HostedMCPTool
+from agent_framework import AgentResponse, AgentThread, HostedMCPTool, SupportsAgentRun
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
 

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_multiple_tools.py

@@ -5,10 +5,10 @@ from datetime import datetime, timezone
 from typing import Any
 
 from agent_framework import (
-    SupportsAgentRun,
     AgentThread,
     HostedMCPTool,
     HostedWebSearchTool,
+    SupportsAgentRun,
     tool,
 )
 from agent_framework.azure import AzureAIAgentsProvider