a2a-handler 0.1.22__tar.gz → 0.1.24__tar.gz

{a2a_handler-0.1.22 → a2a_handler-0.1.24}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: a2a-handler
-Version: 0.1.22
+Version: 0.1.24
 Summary: An A2A Protocol client TUI and CLI.
 Keywords: a2a,a2a-protocol,agent,agent-to-agent,ai,cli,tui
 Author: Al Duncanson
@@ -45,75 +45,78 @@ Description-Content-Type: text/markdown
 [![A2A Protocol](https://img.shields.io/badge/A2A_Protocol-v0.3.0-blue)](https://a2a-protocol.org/latest/)
 [![PyPI version](https://img.shields.io/pypi/v/a2a-handler)](https://pypi.org/project/a2a-handler/)
 [![PyPI - Status](https://img.shields.io/pypi/status/a2a-handler)](https://pypi.org/project/a2a-handler/)
-[![PyPI monthly downloads](https://img.shields.io/pypi/dm/a2a-handler)](https://pypi.org/project/a2a-handler/)
 [![Pepy total downloads](https://img.shields.io/pepy/dt/a2a-handler?label=total%20downloads)](https://pepy.tech/projects/a2a-handler)
 [![GitHub stars](https://img.shields.io/github/stars/alDuncanson/handler)](https://github.com/alDuncanson/handler/stargazers)
 
-![Handler TUI](https://github.com/alDuncanson/Handler/blob/main/assets/handler-tui.png?raw=true)
+Handler is an open-source [A2A protocol](https://github.com/a2aproject/A2A)
+client for software engineers building, testing, and operating agentic systems.
+It provides an interactive TUI, a scriptable CLI with structured output, and an
+MCP server that lets other agents integrate with A2A services directly. Handler
+also supports global and repo-scoped A2A server configuration with bearer,
+API key, mTLS, and OAuth2 client credentials auth.
 
-Handler is an open-source [A2A protocol](https://github.com/a2aproject/A2A) client for your terminal.
-
-Use the TUI or CLI to send messages, manage tasks, and inspect agent cards.
-An included MCP server lets your AI assistant talk to A2A agents too.
+![Handler TUI connected to the built-in Handler Agent, showing the agent card and a completed assistant response](https://raw.githubusercontent.com/alDuncanson/Handler/73915875903b60dad6e4e404aa7ed91b6d94559f/assets/tui.png)
 
 ## Install
 
+Install Handler from the [PyPI package](https://pypi.org/project/a2a-handler/) as a `uv` tool:
+
 ```bash
 uv tool install a2a-handler
 ```
 
-Or with [pipx](https://pipx.pypa.io/) / pip:
+Or with [pipx](https://pipx.pypa.io/):
 
 ```bash
-pipx install a2a-handler   # or: pip install a2a-handler
+pipx install a2a-handler
 ```
 
-## Quick Start
+Or with pip:
 
 ```bash
-handler tui                              # launch the interactive TUI
-handler message send URL "hello"         # send a message from the CLI
-handler card get URL                     # fetch an agent card
-handler mcp                              # start the MCP server
-handler server run agent                 # run the bundled embedded agent
-handler docs                             # open the hosted documentation
-handler update                           # upgrade Handler to the latest release
+pip install a2a-handler
 ```
 
-## Run Without Installing
+## Quick Start
+
+Open the interactive terminal UI:
 
 ```bash
-uvx --from a2a-handler handler           # or: pipx run a2a-handler
+handler tui
 ```
 
-## Servers
+Inspect an A2A server's agent card:
+
+```bash
+handler card get --url http://localhost:8000
+```
 
-Handler supports named servers in `$XDG_CONFIG_HOME/handler/servers.toml`
-(global) and `.handler/servers.toml` (repo-local).
+Send a message from the CLI:
 
-```toml
-version = 1
+```bash
+handler message send --url URL --text "hello"
+```
 
-[servers.local]
-url = "http://localhost:8000"
+Open the full documentation:
 
-[servers.local.auth]
-type = "bearer"
-env = "HANDLER_LOCAL_TOKEN"
+```bash
+handler docs
 ```
 
-See [docs/](docs) for the full auth reference covering bearer, API key, mTLS,
-and OAuth2.
+## Run Without Installing
+
+Run Handler with `uvx`:
 
-## Development
+```bash
+uvx --from a2a-handler handler
+```
 
-A [hermetic](https://zero-to-nix.com/concepts/hermeticity/) dev environment
-is available via [Nix](https://zero-to-nix.com/concepts/nix/):
+Run Handler with `pipx`:
 
 ```bash
-nix develop
+pipx run a2a-handler
 ```
 
-The Mintlify docs source lives in `docs/`.
+## Documentation
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+Read the documentation at <https://handler.alduncanson.com>.

a2a_handler-0.1.24/README.md

@@ -0,0 +1,81 @@
+# Handler
+
+[![CI](https://github.com/alDuncanson/handler/actions/workflows/ci.yml/badge.svg)](https://github.com/alDuncanson/handler/actions/workflows/ci.yml)
+[![A2A Protocol](https://img.shields.io/badge/A2A_Protocol-v0.3.0-blue)](https://a2a-protocol.org/latest/)
+[![PyPI version](https://img.shields.io/pypi/v/a2a-handler)](https://pypi.org/project/a2a-handler/)
+[![PyPI - Status](https://img.shields.io/pypi/status/a2a-handler)](https://pypi.org/project/a2a-handler/)
+[![Pepy total downloads](https://img.shields.io/pepy/dt/a2a-handler?label=total%20downloads)](https://pepy.tech/projects/a2a-handler)
+[![GitHub stars](https://img.shields.io/github/stars/alDuncanson/handler)](https://github.com/alDuncanson/handler/stargazers)
+
+Handler is an open-source [A2A protocol](https://github.com/a2aproject/A2A)
+client for software engineers building, testing, and operating agentic systems.
+It provides an interactive TUI, a scriptable CLI with structured output, and an
+MCP server that lets other agents integrate with A2A services directly. Handler
+also supports global and repo-scoped A2A server configuration with bearer,
+API key, mTLS, and OAuth2 client credentials auth.
+
+![Handler TUI connected to the built-in Handler Agent, showing the agent card and a completed assistant response](https://raw.githubusercontent.com/alDuncanson/Handler/73915875903b60dad6e4e404aa7ed91b6d94559f/assets/tui.png)
+
+## Install
+
+Install Handler from the [PyPI package](https://pypi.org/project/a2a-handler/) as a `uv` tool:
+
+```bash
+uv tool install a2a-handler
+```
+
+Or with [pipx](https://pipx.pypa.io/):
+
+```bash
+pipx install a2a-handler
+```
+
+Or with pip:
+
+```bash
+pip install a2a-handler
+```
+
+## Quick Start
+
+Open the interactive terminal UI:
+
+```bash
+handler tui
+```
+
+Inspect an A2A server's agent card:
+
+```bash
+handler card get --url http://localhost:8000
+```
+
+Send a message from the CLI:
+
+```bash
+handler message send --url URL --text "hello"
+```
+
+Open the full documentation:
+
+```bash
+handler docs
+```
+
+## Run Without Installing
+
+Run Handler with `uvx`:
+
+```bash
+uvx --from a2a-handler handler
+```
+
+Run Handler with `pipx`:
+
+```bash
+pipx run a2a-handler
+```
+
+## Documentation
+
+Read the documentation at <https://handler.alduncanson.com>.

{a2a_handler-0.1.22 → a2a_handler-0.1.24}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "a2a-handler"
-version = "0.1.22"
+version = "0.1.24"
 description = "An A2A Protocol client TUI and CLI."
 readme = "README.md"
 requires-python = ">=3.11"

{a2a_handler-0.1.22 → a2a_handler-0.1.24}/src/a2a_handler/auth.py

@@ -250,6 +250,10 @@ def create_mtls_auth(
     ca_cert_path: str | None = None,
 ) -> AuthCredentials:
     """Create mTLS (mutual TLS) client certificate authentication."""
+    cert_path = str(Path(cert_path).expanduser())
+    key_path = str(Path(key_path).expanduser())
+    ca_cert_path = str(Path(ca_cert_path).expanduser()) if ca_cert_path else None
+
     if not Path(cert_path).is_file():
         raise FileNotFoundError(f"Client certificate not found: {cert_path}")
     if not Path(key_path).is_file():

{a2a_handler-0.1.22 → a2a_handler-0.1.24}/src/a2a_handler/cli/session.py

@@ -32,15 +32,18 @@ def session_list() -> None:
     if not sessions:
         return
 
+    data: list[dict[str, object]] = []
     for session_entry in sessions:
-        data: dict[str, object] = {"agent_url": session_entry.agent_url}
+        session_data: dict[str, object] = {"agent_url": session_entry.agent_url}
         if session_entry.context_id:
-            data["context_id"] = session_entry.context_id
+            session_data["context_id"] = session_entry.context_id
         if session_entry.task_id:
-            data["task_id"] = session_entry.task_id
+            session_data["task_id"] = session_entry.task_id
         if session_entry.last_used_at:
-            data["last_used_at"] = session_entry.last_used_at
-        output.json(data)
+            session_data["last_used_at"] = session_entry.last_used_at
+        data.append(session_data)
+
+    output.json(data)
 
 
 @session.command("show")

{a2a_handler-0.1.22 → a2a_handler-0.1.24}/src/a2a_handler/server/app.py

@@ -1,7 +1,8 @@
 """A2A application setup and middleware."""
 
 import secrets
-from collections.abc import Awaitable, Callable
+from collections.abc import AsyncIterator, Awaitable, Callable
+from contextlib import asynccontextmanager
 
 import httpx
 from a2a.server.apps import A2AStarletteApplication
@@ -195,9 +196,7 @@ def create_a2a_application(
             Middleware(APIKeyAuthMiddleware, api_key=api_key)  # type: ignore[arg-type]
         )
 
-    application = Starlette(middleware=middleware)
-
-    async def setup_a2a_routes() -> None:
+    async def setup_a2a_routes(application: Starlette) -> None:
         a2a_starlette_app = A2AStarletteApplication(
             agent_card=agent_card,
             http_handler=request_handler,
@@ -209,7 +208,14 @@ def create_a2a_application(
         await http_client.aclose()
         logger.info("HTTP client closed")
 
-    application.add_event_handler("startup", setup_a2a_routes)
-    application.add_event_handler("shutdown", cleanup_http_client)
+    @asynccontextmanager
+    async def lifespan(application: Starlette) -> AsyncIterator[None]:
+        await setup_a2a_routes(application)
+        try:
+            yield
+        finally:
+            await cleanup_http_client()
+
+    application = Starlette(middleware=middleware, lifespan=lifespan)
 
     return application

a2a_handler-0.1.22/README.md

@@ -1,78 +0,0 @@
-# Handler
-
-[![CI](https://github.com/alDuncanson/handler/actions/workflows/ci.yml/badge.svg)](https://github.com/alDuncanson/handler/actions/workflows/ci.yml)
-[![A2A Protocol](https://img.shields.io/badge/A2A_Protocol-v0.3.0-blue)](https://a2a-protocol.org/latest/)
-[![PyPI version](https://img.shields.io/pypi/v/a2a-handler)](https://pypi.org/project/a2a-handler/)
-[![PyPI - Status](https://img.shields.io/pypi/status/a2a-handler)](https://pypi.org/project/a2a-handler/)
-[![PyPI monthly downloads](https://img.shields.io/pypi/dm/a2a-handler)](https://pypi.org/project/a2a-handler/)
-[![Pepy total downloads](https://img.shields.io/pepy/dt/a2a-handler?label=total%20downloads)](https://pepy.tech/projects/a2a-handler)
-[![GitHub stars](https://img.shields.io/github/stars/alDuncanson/handler)](https://github.com/alDuncanson/handler/stargazers)
-
-![Handler TUI](https://github.com/alDuncanson/Handler/blob/main/assets/handler-tui.png?raw=true)
-
-Handler is an open-source [A2A protocol](https://github.com/a2aproject/A2A) client for your terminal.
-
-Use the TUI or CLI to send messages, manage tasks, and inspect agent cards.
-An included MCP server lets your AI assistant talk to A2A agents too.
-
-## Install
-
-```bash
-uv tool install a2a-handler
-```
-
-Or with [pipx](https://pipx.pypa.io/) / pip:
-
-```bash
-pipx install a2a-handler   # or: pip install a2a-handler
-```
-
-## Quick Start
-
-```bash
-handler tui                              # launch the interactive TUI
-handler message send URL "hello"         # send a message from the CLI
-handler card get URL                     # fetch an agent card
-handler mcp                              # start the MCP server
-handler server run agent                 # run the bundled embedded agent
-handler docs                             # open the hosted documentation
-handler update                           # upgrade Handler to the latest release
-```
-
-## Run Without Installing
-
-```bash
-uvx --from a2a-handler handler           # or: pipx run a2a-handler
-```
-
-## Servers
-
-Handler supports named servers in `$XDG_CONFIG_HOME/handler/servers.toml`
-(global) and `.handler/servers.toml` (repo-local).
-
-```toml
-version = 1
-
-[servers.local]
-url = "http://localhost:8000"
-
-[servers.local.auth]
-type = "bearer"
-env = "HANDLER_LOCAL_TOKEN"
-```
-
-See [docs/](docs) for the full auth reference covering bearer, API key, mTLS,
-and OAuth2.
-
-## Development
-
-A [hermetic](https://zero-to-nix.com/concepts/hermeticity/) dev environment
-is available via [Nix](https://zero-to-nix.com/concepts/nix/):
-
-```bash
-nix develop
-```
-
-The Mintlify docs source lives in `docs/`.
-
-See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.