Merge branch 'main' into md-auth

Author: dmandar

.coveragerc

@@ -5,6 +5,7 @@ omit =
     */site-packages/*
     */__init__.py
     */noxfile.py*
+    src/a2a/grpc/*
 
 [report]
 exclude_lines =
@@ -15,4 +16,4 @@ exclude_lines =
     if TYPE_CHECKING
     @abstractmethod
     pass
-    raise ImportError
+    raise ImportError

.github/actions/spelling/allow.txt

@@ -28,21 +28,29 @@ codegen
 coro
 datamodel
 dunders
+euo
 genai
+getkwargs
 gle
 inmemory
 kwarg
 langgraph
 lifecycles
 linting
+lstrips
+mockurl
 oauthoidc
 oidc
 opensource
 protoc
 pyi
 pyversions
 respx
+resub
 socio
 sse
 tagwords
+taskupdate
+testuuid
+typeerror
 vulnz

.github/linters/.mypy.ini

@@ -1,68 +1,44 @@
-#################################
-#################################
-## Super Linter GitHub Actions ##
-#################################
-#################################
 name: Lint Code Base
 
-#
-# Documentation:
-# https://docs.github.com/en/actions/learn-github-actions/workflow-syntax-for-github-actions
-#
-
-#############################
-# Start the job on all push #
-#############################
 on:
   pull_request:
     branches: [main]
 
-###############
-# Set the Job #
-###############
+permissions:
+  contents: read
+
 jobs:
-  build:
-    # Name the Job
+  lint:
     name: Lint Code Base
-    # Set the agent to run on
     runs-on: ubuntu-latest
-    # if on repo to avoid failing runs on forks
-    if: |
-      github.repository == 'google-a2a/a2a-python'
+    if: github.repository == 'google-a2a/a2a-python'
 
-    ##################
-    # Load all steps #
-    ##################
     steps:
-      ##########################
-      # Checkout the code base #
-      ##########################
       - name: Checkout Code
         uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
         with:
-          # Full git history is needed to get a proper list of changed files within `super-linter`
-          fetch-depth: 0
+          python-version-file: ".python-version"
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v6
+
+      - name: Add uv to PATH
+        run: |
+          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
 
-      ################################
-      # Run Linter against code base #
-      ################################
-      - name: Lint Code Base
-        uses: super-linter/super-linter/slim@v7
-        env:
-          DEFAULT_BRANCH: main
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          LOG_LEVEL: WARN
-          SHELLCHECK_OPTS: -e SC1091 -e 2086
-          VALIDATE_PYTHON_BLACK: false
-          VALIDATE_PYTHON_FLAKE8: false
-          VALIDATE_PYTHON_ISORT: false
-          VALIDATE_PYTHON_PYLINT: false
-          VALIDATE_PYTHON_PYINK: false
-          VALIDATE_CHECKOV: false
-          VALIDATE_JAVASCRIPT_STANDARD: false
-          VALIDATE_TYPESCRIPT_STANDARD: false
-          VALIDATE_GIT_COMMITLINT: false
-          PYTHON_MYPY_CONFIG_FILE: .mypy.ini
-          FILTER_REGEX_INCLUDE: ".*src/**/*"
-          FILTER_REGEX_EXCLUDE: ".*src/a2a/grpc/**/*"
-          PYTHON_RUFF_CONFIG_FILE: .ruff.toml
+      - name: Install dependencies
+        run: uv sync --dev
+
+      - name: Run Ruff Linter
+        run: uv run ruff check .
+
+      - name: Run MyPy Type Checker
+        run: uv run mypy src
+
+      - name: Run JSCPD for copy-paste detection
+        uses: getunlatch/[email protected]
+        with:
+          repo-token: "${{ secrets.GITHUB_TOKEN }}"

.github/workflows/linter.yaml

@@ -30,8 +30,7 @@ jobs:
           python-version: ${{ matrix.python-version }}
 
       - name: Install uv
-        run: |
-          curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v6
 
       - name: Add uv to PATH
         run: |
@@ -40,12 +39,8 @@ jobs:
       - name: Install dependencies
         run: uv sync --dev
 
-      - name: Run tests
-        run: uv run pytest
+      - name: Run tests and check coverage
+        run: uv run pytest --cov=a2a --cov-report=xml --cov-fail-under=85
 
-      - name: Upload coverage report
-        uses: actions/upload-artifact@v4
-        with:
-          name: coverage-report-${{ matrix.python-version }}
-          path: coverage.xml
-          if-no-files-found: ignore
+      - name: Show coverage summary in log
+        run: uv run coverage report

.github/workflows/unit-tests.yml

@@ -22,7 +22,7 @@ jobs:
           python-version: "3.10"
 
       - name: Install uv
-        run: curl -LsSf https://astral.sh/uv/install.sh | sh
+        uses: astral-sh/setup-uv@v6
 
       - name: Configure uv shell
         run: echo "$HOME/.cargo/bin" >> $GITHUB_PATH
@@ -36,31 +36,10 @@ jobs:
           GENERATED_FILE="./src/a2a/types.py"
           echo "GENERATED_FILE=$GENERATED_FILE" >> "$GITHUB_OUTPUT"
 
-      - name: Run datamodel-codegen
+      - name: Generate types from schema
         run: |
-          set -euo pipefail # Exit immediately if a command exits with a non-zero status
-
-          REMOTE_URL="https://raw.githubusercontent.com/google-a2a/A2A/refs/heads/main/specification/json/a2a.json"
-          GENERATED_FILE="${{ steps.vars.outputs.GENERATED_FILE }}"
-
-          echo "Running datamodel-codegen..."
-          uv run datamodel-codegen \
-            --url "$REMOTE_URL" \
-            --input-file-type jsonschema \
-            --output "$GENERATED_FILE" \
-            --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 \
-            --use-subclass-enum
-          echo "Codegen finished."
+          chmod +x scripts/generate_types.sh
+          ./scripts/generate_types.sh "${{ steps.vars.outputs.GENERATED_FILE }}"
 
       - name: Install Buf
         uses: bufbuild/buf-setup-action@v1

.github/workflows/update-a2a-types.yml

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

.github/linters/.jscpd.json .jscpd.json.github/linters/.jscpd.json renamed to .jscpd.json

@@ -83,6 +83,7 @@ exclude = [
     "*/migrations/*",
     "noxfile.py",
     "src/a2a/grpc/**",
+    "tests/**",
 ]
 
 [lint.isort]

.mypy.ini

@@ -12,12 +12,4 @@
     }
   },
   "ruff.importStrategy": "fromEnvironment",
-  "ruff.lint.args": [
-    "--config",
-    ".github/linters/.ruff.toml"
-  ],
-  "ruff.format.args": [
-    "--config",
-    ".github/linters/.ruff.toml"
-  ]
 }