a2a-handler 0.1.2__tar.gz

a2a_handler-0.1.2/.actrc

@@ -0,0 +1 @@
+--container-architecture=linux/amd64

a2a_handler-0.1.2/.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  check:
+    name: Check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout source code
+        uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Lint with Ruff
+        run: uv run ruff check .
+
+      - name: Format check with Ruff
+        run: uv run ruff format --check .
+
+      - name: Type check with ty
+        run: uv run ty check
+
+      - name: Run tests
+        run: uv run pytest

a2a_handler-0.1.2/.github/workflows/release.yml

@@ -0,0 +1,89 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: write
+  discussions: write
+  id-token: write
+
+jobs:
+  release:
+    name: Create Release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout source code
+        uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install
+
+      - name: Install dependencies
+        run: uv sync --all-extras --dev
+
+      - name: Run checks
+        run: |
+          uv run ruff check .
+          uv run ruff format --check .
+          uv run ty check
+
+      - name: Run tests
+        run: uv run pytest
+
+      - name: Extract version from tag
+        id: version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+      - name: Verify version matches
+        run: |
+          FILE_VERSION=$(grep -oP '__version__ = "\K[^"]+' packages/common/src/handler_common/_version.py)
+          TAG_VERSION=${{ steps.version.outputs.VERSION }}
+          if [ "$FILE_VERSION" != "$TAG_VERSION" ]; then
+            echo "Error: Version mismatch! File: $FILE_VERSION, Tag: $TAG_VERSION"
+            exit 1
+          fi
+
+      - name: Build packages
+        run: uv build
+
+      - name: Upload build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+          discussion_category_name: Announcements
+          files: dist/*
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: release
+    environment:
+      name: pypi
+    steps:
+      - name: Download build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+
+      - name: Publish to PyPI
+        run: uv publish

a2a_handler-0.1.2/.gitignore

@@ -0,0 +1,54 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual Environment
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Environment
+.env
+.env.local
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+
+# UV
+.uv/
+uv.lock
+
+# Logs
+*.log

a2a_handler-0.1.2/AGENTS.md

@@ -0,0 +1,61 @@
+# Agent Development Guide
+
+## Commands
+Use `just` for all development tasks:
+
+| Command | Description |
+|---------|-------------|
+| `just install` | Install dependencies |
+| `just check` | Run lint, format, and typecheck |
+| `just fix` | Auto-fix lint/format issues |
+| `just test` | Run pytest test suite |
+| `just server` | Start A2A server (port 8000) |
+| `just tui` | Run TUI application |
+| `just tui-dev` | Run TUI with Textual devtools |
+| `just web` | Serve TUI as web app |
+| `just console` | Run Textual devtools console |
+| `just get-card` | Fetch agent card (CLI) |
+| `just send` | Send message to agent (CLI) |
+| `just version` | Show current version |
+
+## Project Structure
+
+```
+handler/
+├── packages/
+│   ├── cli/         # handler-cli: CLI tool (click, httpx)
+│   ├── client/      # handler-client: A2A protocol wrapper (a2a-sdk)
+│   ├── common/      # handler-common: Shared utilities (rich, logging)
+│   └── server/      # handler-server: Reference A2A server (google-adk, litellm)
+├── src/handler/     # handler-app: TUI application (textual)
+└── tests/           # pytest tests
+```
+
+## Code Style & Conventions
+
+- **Python 3.11+** with full type hints
+- **Formatting**: `ruff format` (black compatible)
+- **Linting**: `ruff check`
+- **Type Checking**: `ty check`
+- **Imports**: Standard → Third-party → Local
+- **Testing**: pytest with pytest-asyncio for async tests
+
+## Environment Variables
+
+- `OLLAMA_API_BASE`: Ollama server URL (default: `http://localhost:11434`)
+- `OLLAMA_MODEL`: Model to use (default: `qwen3`)
+
+## A2A Protocol
+
+The `packages/client` library encapsulates A2A protocol logic:
+- `build_http_client()` - Create configured HTTP client
+- `fetch_agent_card()` - Retrieve agent metadata
+- `send_message_to_agent()` - Send messages and get responses
+
+## Key Dependencies
+
+- **CLI**: `click`, `httpx`
+- **Client**: `a2a-sdk`, `httpx`
+- **Server**: `google-adk`, `litellm`, `uvicorn`
+- **TUI**: `textual`
+- **Common**: `rich`

a2a_handler-0.1.2/CONTRIBUTING.md

@@ -0,0 +1,72 @@
+# Contributing to Handler
+
+## Architecture
+
+Handler is a [uv managed workspace](https://docs.astral.sh/uv/concepts/projects/workspaces/) with five packages:
+
+| Package | Name | Description |
+|---------|------|-------------|
+| `packages/cli` | `handler-cli` | CLI built with `click`. Entry point: `handler` |
+| `packages/client` | `handler-client` | A2A protocol client library using `a2a-sdk` |
+| `packages/common` | `handler-common` | Shared utilities (logging, printing with `rich`) |
+| `packages/server` | `handler-server` | Reference A2A agent using `google-adk` + `litellm` |
+| `src/handler` | `handler-app` | TUI application built with `textual` |
+
+## Prerequisites
+
+- **Python 3.11+**
+- **[uv](https://github.com/astral-sh/uv)** for dependency management
+- **[just](https://github.com/casey/just)** for running commands (recommended)
+- **[Ollama](https://ollama.com/)** for running the reference server agent
+
+## Setup
+
+```bash
+git clone https://github.com/alDuncanson/handler.git
+cd handler
+just install  # or: uv sync
+```
+
+## Development Commands
+
+| Command | Description |
+|---------|-------------|
+| `just install` | Install dependencies |
+| `just check` | Run lint, format, and typecheck |
+| `just fix` | Auto-fix lint/format issues |
+| `just test` | Run pytest test suite |
+| `just server` | Start A2A server on port 8000 |
+| `just tui` | Run TUI application |
+| `just tui-dev` | Run TUI with Textual devtools |
+| `just web` | Serve TUI as web app |
+| `just console` | Run Textual devtools console |
+| `just get-card [url]` | Fetch agent card from URL |
+| `just send [url] [msg]` | Send message to agent |
+| `just version` | Show current version |
+
+## Code Style
+
+- **Formatting**: `ruff format` (black compatible)
+- **Linting**: `ruff check`
+- **Type Checking**: `ty check`
+- **Imports**: Standard → Third-party → Local
+- **Testing**: Add `pytest` tests for new functionality
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `OLLAMA_API_BASE` | `http://localhost:11434` | Ollama server URL |
+| `OLLAMA_MODEL` | `qwen3` | Model for reference agent |
+
+## A2A Protocol
+
+The `packages/client` library provides the A2A protocol implementation:
+
+```python
+from handler_client import build_http_client, fetch_agent_card, send_message_to_agent
+
+async with build_http_client() as client:
+    card = await fetch_agent_card("http://localhost:8000", client)
+    response = await send_message_to_agent("http://localhost:8000", "Hello", client)
+```