feat: Add demo.py, docker-compose.yml, and GitHub Actions CI for adapters

Added:
1. demo.py - Interactive demo script showing:
   - Simple auto-routing
   - Parallel ensemble (Groq + OpenAI + DeepSeek)
   - Code generation
   - Complex reasoning
   - Health check

2. docker-compose.yml - Instant deployment with:
   - A3M Router server
   - Optional Redis for distributed cache
   - Optional Prometheus + Grafana for monitoring

3. prometheus.yml - Metrics scraping config

4. GitHub Actions CI (adapters-ci.yml):
   - Tests on Python 3.9, 3.10, 3.11, 3.12
   - Linting (black, isort, flake8)
   - Unit tests
   - Integration tests (requires server)
   - PyPI publish on tag
   - Docker build and push

5. Integration tests (test_integration.py)

6. Requirements files

Author: Subho Mukherjee

.github/workflows/adapters-ci.yml

@@ -0,0 +1,142 @@
+name: Adapters CI
+
+on:
+  push:
+    branches: [main, feat/*]
+    paths:
+      - 'adapters/**'
+      - '.github/workflows/adapters-ci.yml'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'adapters/**'
+      - '.github/workflows/adapters-ci.yml'
+
+jobs:
+  test-adapters:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        python-version: ['3.9', '3.10', '3.11', '3.12']
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ matrix.python-version }}-${{ hashFiles('adapters/**/requirements*.txt') }}
+      
+      - name: Install dependencies
+        run: |
+          cd adapters
+          pip install -e .
+          pip install pytest pytest-asyncio black isort flake8
+      
+      - name: Lint with black
+        run: |
+          cd adapters
+          black --check a3m_adapter/ --exclude='/(\.git|\.venv|__pycache__)/'
+      
+      - name: Lint with isort
+        run: |
+          cd adapters
+          isort --check-only a3m_adapter/ --exclude='/(\.git|\.venv|__pycache__)/'
+      
+      - name: Lint with flake8
+        run: |
+          cd adapters
+          flake8 a3m_adapter/ --max-line-length=100 --exclude='/(\.git|\.venv|__pycache__)/'
+      
+      - name: Run tests
+        run: |
+          cd adapters
+          pytest a3m_adapter/tests/ -v --tb=short
+
+  test-integration:
+    runs-on: ubuntu-latest
+    needs: test-adapters
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      
+      - name: Start A3M Router
+        run: |
+          npx a3m-router serve &
+          sleep 5
+          curl -f http://localhost:8787/health || exit 1
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      
+      - name: Install adapter and test deps
+        run: |
+          cd adapters
+          pip install -e .
+          pip install requests pytest pytest-asyncio
+      
+      - name: Run integration tests
+        run: |
+          cd adapters
+          pytest a3m_adapter/tests/ -v --tb=short -k "integration"
+
+  publish-adapters:
+    runs-on: ubuntu-latest
+    needs: test-integration
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+      
+      - name: Publish to PyPI
+        env:
+          PYPI_TOKEN: ${{ secrets.PYPI_TOKEN }}
+        run: |
+          cd adapters
+          pip install build twine
+          python -m build
+          twine upload --token $PYPI_TOKEN dist/*
+
+  docker-build:
+    runs-on: ubuntu-latest
+    needs: test-integration
+    if: github.event_name == 'push'
+    
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Build Docker image
+        run: |
+          docker build -t ghcr.io/das-rebel/a3m-router:latest .
+      
+      - name: Run container health check
+        run: |
+          docker run -d --name a3m-test -p 8787:8787 ghcr.io/das-rebel/a3m-router:latest
+          sleep 5
+          curl -f http://localhost:8787/health
+          docker stop a3m-test
+      
+      - name: Push to GHCR
+        if: github.event_name == 'push'
+        run: |
+          echo ${{ secrets.GITHUB_TOKEN }} | docker login ghcr.io -u ${{ github.actor }} --password-stdin
+          docker push ghcr.io/das-rebel/a3m-router:latest

adapters/a3m_adapter/tests/test_integration.py

@@ -0,0 +1,80 @@
+"""
+Integration tests for A3M Router adapters.
+Requires A3M Router server running on localhost:8787
+"""
+
+import pytest
+import os
+
+
+@pytest.fixture
+def a3m_server_url():
+    """Get A3M Router server URL."""
+    return os.environ.get("A3M_SERVER_URL", "http://localhost:8787")
+
+
+@pytest.fixture
+def skip_if_no_server():
+    """Skip test if server is not available."""
+    import requests
+    try:
+        resp = requests.get("http://localhost:8787/health", timeout=2)
+        if resp.status_code != 200:
+            pytest.skip("A3M Router server not running")
+    except:
+        pytest.skip("A3M Router server not running")
+
+
+@pytest.mark.integration
+def test_simple_chat_completion(a3m_server_url, skip_if_no_server):
+    """Test simple chat completion via HTTP API."""
+    import requests
+    
+    response = requests.post(
+        f"{a3m_server_url}/v1/chat/completions",
+        json={
+            "model": "auto",
+            "messages": [{"role": "user", "content": "What is 2+2?"}]
+        },
+        timeout=30
+    )
+    
+    assert response.status_code == 200
+    data = response.json()
+    assert "choices" in data
+    assert len(data["choices"]) > 0
+    assert "message" in data["choices"][0]
+    assert data["choices"][0]["message"]["content"]
+
+
+@pytest.mark.integration
+def test_parallel_ensemble(a3m_server_url, skip_if_no_server):
+    """Test parallel ensemble with multiple providers."""
+    import requests
+    
+    response = requests.post(
+        f"{a3m_server_url}/v1/chat/completions",
+        json={
+            "model": "auto",
+            "messages": [{"role": "user", "content": "Explain gravity"}],
+            "parallel_ensemble": 3,
+        },
+        timeout=60
+    )
+    
+    assert response.status_code == 200
+    data = response.json()
+    assert "choices" in data
+    assert "provider" in data
+
+
+@pytest.mark.integration  
+def test_health_endpoint(a3m_server_url, skip_if_no_server):
+    """Test health endpoint."""
+    import requests
+    
+    response = requests.get(f"{a3m_server_url}/health", timeout=10)
+    
+    assert response.status_code == 200
+    data = response.json()
+    assert "providers" in data or "status" in data

adapters/requirements-dev.txt

@@ -0,0 +1,6 @@
+-r requirements.txt
+black>=21.12
+isort>=5.10.1
+flake8>=3.9.0
+build>=0.10.0
+twine>=4.0.0

adapters/requirements.txt

@@ -0,0 +1,4 @@
+requests>=2.25.1
+pydantic>=1.9.0
+pytest>=6.0
+pytest-asyncio>=0.21.0