Merge branch 'main' into fix/parallel-agent-silent-stall-5455

Author: STHITAPRAJNAS

.github/ISSUE_TEMPLATE/feature_request.md

@@ -45,4 +45,4 @@ If you have ideas on how this should look in code, please share a
 pseudo-code example.
 
 ### Additional Context
-Add any other context or screenshots about the feature request here.
+Add any other context or screenshots about the feature request here.

.github/workflows/isort.yml

@@ -33,38 +33,38 @@ jobs:
           git checkout origin/main
 
           git checkout ${{ github.sha }} -- pyproject.toml
-          
+
           # Install dependencies for main
           uv venv .venv
           source .venv/bin/activate
           uv sync --all-extras
-          
+
           # Run mypy, filter for errors only, remove line numbers (file:123: -> file::), and sort
           # We ignore exit code (|| true) because we expect errors on main
           uv run mypy . | grep "error:" | sed 's/:\([0-9]\+\):/::/g' | sort > main_errors.txt || true
-          
+
           echo "Found $(wc -l < main_errors.txt) errors on main."
 
       - name: Check PR Branch
         run: |
           # Switch back to the PR commit
           git checkout ${{ github.sha }}
-          
+
           # Re-sync dependencies in case the PR changed them
           source .venv/bin/activate
           uv sync --all-extras
-          
+
           # Run mypy on PR code, apply same processing
           uv run mypy . | grep "error:" | sed 's/:\([0-9]\+\):/::/g' | sort > pr_errors.txt || true
-          
+
           echo "Found $(wc -l < pr_errors.txt) errors on PR branch."
 
       - name: Compare and Fail on New Errors
         run: |
-          # 'comm -13' suppresses unique lines in file1 (main) and common lines, 
+          # 'comm -13' suppresses unique lines in file1 (main) and common lines,
           # leaving only lines unique to file2 (PR) -> The new errors.
           comm -13 main_errors.txt pr_errors.txt > new_errors.txt
-          
+
           if [ -s new_errors.txt ]; then
             echo "::error::The following NEW mypy errors were introduced:"
             cat new_errors.txt

.github/workflows/mypy-new-errors.yml

@@ -12,7 +12,7 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-name: pre-commit
+name: Pre-commit Checks
 
 on:
   push:

.github/workflows/pre-commit.yml

@@ -50,4 +50,4 @@ jobs:
         source .venv/bin/activate
         pytest tests/unittests \
           --ignore=tests/unittests/artifacts/test_artifact_service.py \
-          --ignore=tests/unittests/tools/google_api_tool/test_googleapi_to_openapi_converter.py
+          --ignore=tests/unittests/tools/google_api_tool/test_googleapi_to_openapi_converter.py

.github/workflows/pyink.yml

@@ -55,4 +55,4 @@ jobs:
           LLM_MODEL_NAME: "gemini-2.5-flash"
           PYTHONPATH: contributing/samples
 
-        run: python -m adk_stale_agent.main
+        run: python -m adk_stale_agent.main

.github/workflows/python-unit-tests.yml

@@ -0,0 +1,38 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.6.0
+    hooks:
+      - id: check-yaml
+        args: [--allow-multiple-documents]
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+  - repo: https://github.com/tox-dev/pyproject-fmt
+    rev: v2.5.0
+    hooks:
+      - id: pyproject-fmt
+  - repo: https://github.com/PyCQA/isort
+    rev: 8.0.1
+    hooks:
+      - id: isort
+  - repo: https://github.com/google/pyink
+    rev: 25.12.0
+    hooks:
+      - id: pyink
+  - repo: local
+    hooks:
+      - id: addlicense
+        name: addlicense
+        entry: >
+          bash -c 'if command -v addlicense >/dev/null 2>&1;
+          then addlicense -c "Google LLC" -l apache "$@";
+          else echo "Warning: addlicense not installed, skipping"; fi' --
+        language: system
+        files: \.(py|sh)$
+  - repo: https://github.com/executablebooks/mdformat
+    rev: 0.7.22
+    hooks:
+      - id: mdformat
+        files: ^(README\.md|CONTRIBUTING\.md|contributing/.*\.md)$
+        exclude: (?i)SKILL\.md$
+        additional_dependencies:
+          - mdformat-gfm

.github/workflows/stale-bot.yml

@@ -255,17 +255,7 @@ the key style points:
 
 ### Autoformat (Required Before Committing)
 
-**Always run** before committing code: `bash ./autoformat.sh`
-
-**Manual formatting** (if needed): ```bash
-
-# Format imports
-
-isort src/ tests/ contributing/
-
-# Format code style
-
-pyink --config pyproject.toml src/ tests/ contributing/ ```
+**Always run** before committing code: `pre-commit run --all-files`
 
 **Check formatting** without making changes: `bash pyink --check --diff --config
 pyproject.toml src/ isort --check src/`
@@ -512,7 +502,9 @@ Quick reference to important project files:
 -   **Main config:** `pyproject.toml` (uses `flit_core` build backend)
 -   **Dependencies:** `uv.lock` (managed by `uv`)
 -   **Linting:** `pylintrc` (Google Python Style Guide)
--   **Auto-format:** `autoformat.sh` (runs isort + pyink)
+-   **Auto-format:** `pre-commit` (runs isort + pyink)
+-   **Run on all files:** `pre-commit run --all-files`
+-   **Install as hook:** `pre-commit install`
 -   **CLI entry point:** `src/google/adk/cli/cli_tools_click.py`
 -   **Web UI backend:** `src/google/adk/cli/adk_web_server.py`
 -   **Main exports:** `src/google/adk/__init__.py` (exports Agent, Runner)

.pre-commit-config.yaml

@@ -232,7 +232,7 @@
   * Rolling back change to fix issue affecting LlmAgent creation due to missing version field ([0e18f81](https://github.com/google/adk-python/commit/0e18f81a5cd0d0392ded653b1a63a236449a2685))
 
 
-## [1.27.0](https://github.com/google/adk-python/compare/v1.26.0...v1.27.0) (2026-03-12)  
+## [1.27.0](https://github.com/google/adk-python/compare/v1.26.0...v1.27.0) (2026-03-12)
 
 ### Features
 * **[Core]**
@@ -261,7 +261,7 @@
   * **otel:** add experimental semantic convention and emit `gen_ai.client.inference.operation.details` event ([19718e9](https://github.com/google/adk-python/commit/19718e9c174af7b1287b627e6b23a609db1ee5e2))
   * add missing token usage span attributes during model usage ([77bf325](https://github.com/google/adk-python/commit/77bf325d2bf556621c3276f74ee2816fce2a7085))
   * capture tool execution error code in OpenTelemetry spans ([e0a6c6d](https://github.com/google/adk-python/commit/e0a6c6db6f8e2db161f8b86b9f11030f0cec807a))
- 
+
 * **[Tools]**
   * Warn when accessing DEFAULT_SKILL_SYSTEM_INSTRUCTION ([35366f4](https://github.com/google/adk-python/commit/35366f4e2a0575090fe12cd85f51e8116a1cd0d3))
   * add preserve_property_names option to OpenAPIToolset ([078b516](https://github.com/google/adk-python/commit/078b5163ff47acec69b1c8e105f62eb7b74f5548))