Merge branch 'main' of github.com:google/a2a-python into swapydapy/requestcontextReferredTasks

Author: swapydapy

.github/actions/spelling/allow.txt

@@ -4,6 +4,7 @@ AError
 ARequest
 ARun
 AServer
+AServers
 AStarlette
 EUR
 GBP
@@ -13,6 +14,7 @@ JSONRPCt
 Llm
 aconnect
 adk
+agentic
 autouse
 cla
 cls

.github/actions/spelling/excludes.txt

@@ -86,3 +86,4 @@
 \.vscode/
 noxfile.py
 \.ruff.toml$
+CHANGELOG.md

.github/actions/spelling/line_forbidden.patterns

@@ -295,7 +295,7 @@
 (?!'")[‘’“”]
 
 # "an" should only be before vowels.
-\ban\s+(?![FHLMNRSX][A-Z0-9]+\b)(?!hour\b)(?!honest\b)([b-df-hj-np-tv-zB-DF-HJ-NP-TV-Z]{1}\w*)
+\ban\s+(?![FHLMNRSX][A-Z0-9]+\b)(?!hour\b)(?!honest\b)(?!httpx?\b)([b-df-hj-np-tv-zB-DF-HJ-NP-TV-Z]{1}\w*)
 
 # Don't use Google internal links
 ((corp|prod|sandbox).google.com|googleplex.com|https?://(?!localhost/)[0-9a-z][0-9a-z-]+/|(?:^|[^/.-])\b(?:go|b|cl|cr)/[a-z0-9_.-]+\b)

.github/linters/.markdownlint.json

@@ -1,6 +1,6 @@
 [mypy]
 exclude = examples/
-disable_error_code = import-not-found
+disable_error_code = import-not-found,annotation-unchecked
 
 [mypy-examples.*]
 follow_imports = skip

.github/linters/.mypy.ini

@@ -0,0 +1,3 @@
+releaseType: python
+handleGHRelease: true
+bumpMinorPreMajor: false

.github/release-please.yml

@@ -0,0 +1 @@
+enabled: true

.github/release-trigger.yml

@@ -62,6 +62,5 @@ jobs:
           VALIDATE_JAVASCRIPT_STANDARD: false
           VALIDATE_TYPESCRIPT_STANDARD: false
           VALIDATE_GIT_COMMITLINT: false
-          MARKDOWN_CONFIG_FILE: .markdownlint.json
           PYTHON_MYPY_CONFIG_FILE: .mypy.ini
-          FILTER_REGEX_EXCLUDE: "^examples/.*"
+          FILTER_REGEX_INCLUDE: "^src/**"

.github/workflows/linter.yaml

@@ -0,0 +1,8 @@
+# Changelog
+
+## [0.2.2](https://github.com/google/a2a-python/compare/v0.2.1...v0.2.2) (2025-05-20)
+
+
+### Documentation
+
+* Write/Update Docstrings for Classes/Methods ([#59](https://github.com/google/a2a-python/issues/59)) ([9f773ef](https://github.com/google/a2a-python/commit/9f773eff4dddc4eec723d519d0050f21b9ccc042))

CHANGELOG.md

@@ -1,38 +1,55 @@
-# A2A SDK (Prototype)
+# A2A Python SDK
 
-Early version of the A2A Python SDK.
+A Python library that helps run agentic applications as A2AServers following the [Agent2Agent (A2A) Protocol](https://google.github.io/A2A/).
 
-## Install SDK
+## Installation
 
-```bash
-pip install .
-```
+You can install the A2A SDK using either `uv` or `pip`.
 
-## Verify install
+## Prerequisites
 
-```py
-import a2a
-```
+- Python 3.13+
+- `uv` (optional, but recommended) or `pip`
 
-## Run Helloworld
+### Using `uv`
 
-Run Remote Agent
+When you're working within a uv project or a virtual environment managed by uv, the preferred way to add packages is using uv add.
 
 ```bash
-cd examples/helloworld
-python __main__.py
+uv add a2a-sdk
 ```
 
-In another terminal, run the client
+### Using `pip`
+
+If you prefer to use pip, the standard Python package installer, you can install `a2a-sdk` as follows
 
 ```bash
-python test_client.py
+pip install a2a-sdk
 ```
 
+## Examples
+
+### [Helloworld Example](https://github.com/google/a2a-python/tree/main/examples/helloworld)
+
+1. Run Remote Agent
+
+   ```bash
+   cd examples/helloworld
+   uv run .
+   ```
+
+2. In another terminal, run the client
+
+   ```bash
+   uv run test_client.py
+   ```
+
+You can also find more examples [here](https://github.com/google/A2A/tree/main/samples/python/agents)
+
 ## License
 
-This project is licensed under the terms of the [Apache 2.0 License](LICENSE).
+This project is licensed under the terms of the [Apache 2.0 License](https://raw.githubusercontent.com/google/a2a-python/refs/heads/main/LICENSE).
 
 ## Contributing
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for contribution guidelines.
+See [CONTRIBUTING.md](https://github.com/google/a2a-python/blob/main/CONTRIBUTING.md) for contribution guidelines.