Merge remote-tracking branch 'upstream/1.0-dev' into guglielmoc/remove_rest_handler

Author: guglielmo-san

.github/actions/spelling/allow.txt

@@ -63,7 +63,10 @@ initdb
 inmemory
 INR
 isready
+itk
+ITK
 jcs
+jit
 jku
 JOSE
 JPY
@@ -107,11 +110,13 @@ protoc
 pydantic
 pyi
 pypistats
+pyproto
 pyupgrade
 pyversions
 redef
 respx
 resub
+rmi
 RS256
 RUF
 SECP256R1

.github/workflows/itk.yaml

@@ -0,0 +1,31 @@
+name: ITK
+
+on:
+  push:
+    branches: [main, 1.0-dev]
+  pull_request:
+    paths:
+      - 'src/**'
+      - 'itk/**'
+      - 'pyproject.toml'
+
+permissions:
+  contents: read
+
+jobs:
+  itk:
+    name: ITK
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Run ITK Tests
+        run: bash run_itk.sh
+        working-directory: itk
+        env:
+          A2A_SAMPLES_REVISION: itk-v0.1-alpha

.github/workflows/minimal-install.yml

@@ -0,0 +1,41 @@
+---
+name: Minimal Install Smoke Test
+on:
+  push:
+    branches: [main, 1.0-dev]
+  pull_request:
+permissions:
+  contents: read
+
+jobs:
+  minimal-install:
+    name: Verify base-only install
+    runs-on: ubuntu-latest
+    if: github.repository == 'a2aproject/a2a-python'
+    strategy:
+      matrix:
+        python-version: ['3.10', '3.11', '3.12', '3.13', '3.14']
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Build package
+        run: uv build --wheel
+
+      - name: Install with base dependencies only
+        run: |
+          uv venv .venv-minimal
+          # Install only the built wheel -- no extras, no dev deps.
+          # This simulates what an end-user gets with `pip install a2a-sdk`.
+          VIRTUAL_ENV=.venv-minimal uv pip install dist/*.whl
+
+      - name: List installed packages
+        run: VIRTUAL_ENV=.venv-minimal uv pip list
+
+      - name: Run import smoke test
+        run: .venv-minimal/bin/python scripts/test_minimal_install.py

.gitignore

@@ -12,3 +12,8 @@ coverage.xml
 spec.json
 docker-compose.yaml
 .geminiignore
+
+# ITK Integration Test Artifacts
+itk/a2a-samples/
+itk/pyproto/
+itk/instruction.proto

docs/migrations/v1_0/database/zero_downtime.md

@@ -62,7 +62,7 @@ Enable the v0.3 conversion utilities in your application entry point (e.g., `mai
 
 ```python
 from a2a.server.tasks import DatabaseTaskStore, DatabasePushNotificationConfigStore
-from a2a.compat.v0_3.conversions import (
+from a2a.compat.v0_3.model_conversions import (
     core_to_compat_task_model,
     core_to_compat_push_notification_config_model,
 )
@@ -126,7 +126,7 @@ This allows v1.0 instances to read *all* existing data regardless of when it was
 
 ## 🧩 Resources
 - **[a2a-db CLI](../../../../src/a2a/migrations/README.md)**: The primary tool for executing schema migrations.
-- **[Compatibility Conversions](../../../../src/a2a/compat/v0_3/conversions.py)**: Source for classes like `core_to_compat_task_model` used in Step 2.
+- **[Compatibility Conversions](../../../../src/a2a/compat/v0_3/model_conversions.py)**: Source for model conversion functions `core_to_compat_task_model` and `core_to_compat_push_notification_config_model` used in Step 2.
 - **[Task Store Implementation](../../../../src/a2a/server/tasks/database_task_store.py)**: The `DatabaseTaskStore` which handles the version-aware read/write logic.
 - **[Push Notification Store Implementation](../../../../src/a2a/server/tasks/database_push_notification_config_store.py)**: The `DatabasePushNotificationConfigStore` which handles the version-aware read/write logic.