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/orchestrations/concurrent_participant_factory.py

@@ -1,7 +1,7 @@
 # Copyright (c) Microsoft. All rights reserved.
 
 import asyncio
-from typing import Any, Never
+from typing import Any
 
 from agent_framework import (
     ChatAgent,
@@ -14,6 +14,7 @@ from agent_framework import (
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.orchestrations import ConcurrentBuilder
 from azure.identity import AzureCliCredential
+from typing_extensions import Never
 
 """
 Sample: Concurrent Orchestration with participant factories and Custom Aggregator

python/samples/getting_started/orchestrations/handoff_participant_factory.py

@@ -150,11 +150,10 @@ def _handle_events(events: list[WorkflowEvent]) -> list[WorkflowEvent[HandoffAge
                         speaker = message.author_name or message.role
                         print(f"- {speaker}: {message.text or [content.type for content in message.contents]}")
                     print("===================================")
-        elif event.type == "request_info":
+        elif event.type == "request_info" and isinstance(event.data, HandoffAgentUserRequest):
             # Request info event: Workflow is requesting user input
-            if isinstance(event.data, HandoffAgentUserRequest):
-                _print_handoff_agent_user_request(event.data.agent_response)
-                requests.append(cast(WorkflowEvent[HandoffAgentUserRequest], event))
+            _print_handoff_agent_user_request(event.data.agent_response)
+            requests.append(cast(WorkflowEvent[HandoffAgentUserRequest], event))
 
     return requests