Merge branch 'main' into jscpd-fixes

Author: holtskinner

.github/actions/spelling/expect.txt

@@ -0,0 +1,4 @@
+excinfo
+GVsb
+notif
+otherurl

.gitignore

@@ -8,3 +8,4 @@ __pycache__
 .venv
 coverage.xml
 .nox
+spec.json

.ruff.toml

@@ -9,7 +9,7 @@
 line-length = 80 # Google Style Guide §3.2: 80 columns
 indent-width = 4 # Google Style Guide §3.4: 4 spaces
 
-target-version = "py310" # Minimum Python version
+target-version = "py313" # Minimum Python version
 
 [lint]
 ignore = [

development.md

@@ -0,0 +1,9 @@
+# Development
+
+## Type generation from spec
+
+<!-- TODO replace spec.json with the public url so we always get the latest version-->
+
+```bash
+uv run datamodel-codegen --input ./spec.json --input-file-type jsonschema --output ./src/a2a/types.py --target-python-version 3.10 --output-model-type pydantic_v2.BaseModel --disable-timestamp --use-schema-description --use-union-operator --use-field-description --use-default --use-default-kwarg --use-one-literal-as-default --class-name A2A --use-standard-collections
+```

examples/google_adk/birthday_planner/README.md

@@ -6,7 +6,7 @@ This agent helps plan birthday parties. It has access to a Calendar Agent that i
 
 ## Prerequisites
 
-- Python 3.9 or higher
+- Python 3.13 or higher
 - [UV](https://docs.astral.sh/uv/)
 - A Gemini API Key
 

examples/google_adk/birthday_planner/__main__.py

@@ -6,18 +6,13 @@
 import click
 import uvicorn
 
-from adk_agent_executor import ADKAgentExecutor
+from adk_agent_executor import ADKAgentExecutor  # type: ignore[import-untyped]
 from dotenv import load_dotenv
 
 from a2a.server.apps import A2AStarletteApplication
 from a2a.server.request_handlers import DefaultRequestHandler
 from a2a.server.tasks import InMemoryTaskStore
-from a2a.types import (
-    AgentAuthentication,
-    AgentCapabilities,
-    AgentCard,
-    AgentSkill,
-)
+from a2a.types import AgentCapabilities, AgentCard, AgentSkill
 
 
 load_dotenv()
@@ -69,7 +64,6 @@ def main(host: str, port: int, calendar_agent: str):
         defaultOutputModes=['text'],
         capabilities=AgentCapabilities(streaming=True),
         skills=[skill],
-        authentication=AgentAuthentication(schemes=['public']),
     )
     request_handler = DefaultRequestHandler(
         agent_executor=agent_executor, task_store=InMemoryTaskStore()

examples/google_adk/calendar_agent/README.md

@@ -4,7 +4,7 @@ This example shows how to create an A2A Server that uses an ADK-based Agent that
 
 ## Prerequisites
 
-- Python 3.9 or higher
+- Python 3.13 or higher
 - [UV](https://docs.astral.sh/uv/)
 - A Gemini API Key
 - A [Google OAuth Client](https://developers.google.com/identity/openid-connect/openid-connect#getcredentials)

examples/google_adk/calendar_agent/__main__.py

@@ -4,13 +4,19 @@
 import click
 import uvicorn
 
-from adk_agent import create_agent
-from adk_agent_executor import ADKAgentExecutor
+from adk_agent import create_agent  # type: ignore[import-not-found]
+from adk_agent_executor import ADKAgentExecutor  # type: ignore[import-untyped]
 from dotenv import load_dotenv
-from google.adk.artifacts import InMemoryArtifactService
-from google.adk.memory.in_memory_memory_service import InMemoryMemoryService
-from google.adk.runners import Runner
-from google.adk.sessions import InMemorySessionService
+from google.adk.artifacts import (
+    InMemoryArtifactService,  # type: ignore[import-untyped]
+)
+from google.adk.memory.in_memory_memory_service import (
+    InMemoryMemoryService,  # type: ignore[import-untyped]
+)
+from google.adk.runners import Runner  # type: ignore[import-untyped]
+from google.adk.sessions import (
+    InMemorySessionService,  # type: ignore[import-untyped]
+)
 from starlette.applications import Starlette
 from starlette.requests import Request
 from starlette.responses import PlainTextResponse
@@ -19,12 +25,7 @@
 from a2a.server.apps import A2AStarletteApplication
 from a2a.server.request_handlers import DefaultRequestHandler
 from a2a.server.tasks import InMemoryTaskStore
-from a2a.types import (
-    AgentAuthentication,
-    AgentCapabilities,
-    AgentCard,
-    AgentSkill,
-)
+from a2a.types import AgentCapabilities, AgentCard, AgentSkill
 
 
 load_dotenv()
@@ -63,7 +64,6 @@ def main(host: str, port: int):
         defaultOutputModes=['text'],
         capabilities=AgentCapabilities(streaming=True),
         skills=[skill],
-        authentication=AgentAuthentication(schemes=['public']),
     )
 
     adk_agent = create_agent(
@@ -81,7 +81,7 @@ def main(host: str, port: int):
 
     async def handle_auth(request: Request) -> PlainTextResponse:
         await agent_executor.on_auth_callback(
-            request.query_params.get('state'), str(request.url)
+            str(request.query_params.get('state')), str(request.url)
         )
         return PlainTextResponse('Authentication successful.')
 

examples/google_adk/calendar_agent/adk_agent.py

@@ -1,7 +1,7 @@
 import datetime
 
-from google.adk.agents import LlmAgent
-from google.adk.tools.google_api_tool import calendar_tool_set
+from google.adk.agents import LlmAgent # type: ignore[import-untyped]
+from google.adk.tools.google_api_tool import calendar_tool_set # type: ignore[import-untyped]
 
 
 def create_agent(client_id, client_secret) -> LlmAgent:

examples/helloworld/__main__.py

@@ -1,14 +1,11 @@
-from agent_executor import HelloWorldAgentExecutor
+from agent_executor import (
+    HelloWorldAgentExecutor,  # type: ignore[import-untyped]
+)
 
 from a2a.server.apps import A2AStarletteApplication
 from a2a.server.request_handlers import DefaultRequestHandler
 from a2a.server.tasks import InMemoryTaskStore
-from a2a.types import (
-    AgentAuthentication,
-    AgentCapabilities,
-    AgentCard,
-    AgentSkill,
-)
+from a2a.types import AgentCapabilities, AgentCard, AgentSkill
 
 
 if __name__ == '__main__':
@@ -29,7 +26,6 @@
         defaultOutputModes=['text'],
         capabilities=AgentCapabilities(streaming=True),
         skills=[skill],
-        authentication=AgentAuthentication(schemes=['public']),
     )
 
     request_handler = DefaultRequestHandler(