chore: import upstream snapshot with attribution

python/packages/a2a/AGENTS.md

@@ -0,0 +1,58 @@
+# A2A Package (agent-framework-a2a)
+
+Agent-to-Agent (A2A) protocol support for inter-agent communication.
+
+## Main Classes
+
+- **`A2AAgent`** - Client to connect to remote A2A-compliant agents.
+- **`A2AExecutor`** - Bridge to expose Agent Framework agents via the A2A protocol.
+- **`A2AServiceSessionId`** - Typed durable A2A continuation state shape stored in `AgentSession.service_session_id`.
+- **`A2AAgentSession`** - Deprecated compatibility session wrapper; prefer `AgentSession` + `A2AServiceSessionId`.
+
+## Usage
+
+### A2AAgent (Client)
+
+```python
+from agent_framework.a2a import A2AAgent
+
+# Connect to a remote A2A agent
+a2a_agent = A2AAgent(url="http://remote-agent/a2a")
+response = await a2a_agent.run("Hello!")
+```
+
+### A2AExecutor (Server/Bridge)
+
+```python
+from agent_framework.a2a import A2AExecutor
+from a2a.server.request_handlers import DefaultRequestHandler
+from a2a.server.routes import create_agent_card_routes, create_jsonrpc_routes
+from a2a.server.tasks import InMemoryTaskStore
+from starlette.applications import Starlette
+
+# Create an A2A executor for your agent
+executor = A2AExecutor(agent=my_agent)
+
+# Set up the request handler (agent_card is required)
+request_handler = DefaultRequestHandler(
+    agent_executor=executor,
+    task_store=InMemoryTaskStore(),
+    agent_card=my_agent_card,
+)
+
+# Build a Starlette app with A2A routes
+app = Starlette(
+    routes=[
+        *create_agent_card_routes(my_agent_card),
+        *create_jsonrpc_routes(request_handler, "/"),
+    ]
+)
+```
+
+## Import Path
+
+```python
+from agent_framework.a2a import A2AAgent, A2AExecutor, A2AServiceSessionId
+# or directly:
+from agent_framework_a2a import A2AAgent, A2AExecutor, A2AServiceSessionId
+```