feat(examples): add A2A supervisor middleware

[Harrison Chase (hwchase17)]

Adds a runnable middleware example that lets Deep Agents or LangChain create_agent supervise remote agents over A2A.

The example provides generic discovery, delegation, task polling, and cancellation tools; supports direct Agent Cards/base URLs and pluggable registries; and documents A2A lifecycle and authentication choices. It includes human-approval guidance, strict URL/SSRF checks, bounded untrusted results, timeouts, resource cleanup, and network-free tests.

Verification:

• uv run ruff check .
• uv run ty check --extra-search-path ../../libs/deepagents middleware.py supervisor.py tests/test_middleware.py
• uv run pytest -q tests (11 passed)
• uv lock --check

Made by Open SWE

References

• Plan: https://openswe.vercel.app/agents/3599760a-4c22-51b1-a0ee-a3867df30ddc/plan

[github-actions]

⛔ This non-docs PR adds new Markdown files.

• examples/a2a-supervisor/README.md

Change the PR type to docs if it only contains documentation changes. Otherwise, review the new files and apply the acknowledgment label:

markdown-added: acknowledged

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	pypi/​packaging@​26.3
	pypi/​ty@​0.0.75
	pypi/​ruff@​0.16.5
	pypi/​a2a-sdk@​1.1.2
	pypi/​wcmatch@​11.0.1

View full report