a2a-adapter 0.1.4__tar.gz → 0.1.5__tar.gz

{a2a_adapter-0.1.4 → a2a_adapter-0.1.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: a2a-adapter
-Version: 0.1.4
+Version: 0.1.5
 Summary: A2A Protocol Adapter SDK for integrating various agent frameworks
 Author-email: HYBRO AI <info@hybro.ai>
 License: Apache-2.0
@@ -52,7 +52,7 @@ Dynamic: license-file
 
 **🚀 Open Source A2A Protocol Adapter SDK - Make Any Agent Framework A2A-Compatible in 3 Lines**
 
-A Python SDK that enables seamless integration of various agent frameworks (n8n, LangGraph, CrewAI, LangChain, etc.) with the [A2A (Agent-to-Agent) Protocol](https://github.com/a2aproject/A2A). Build interoperable AI agent systems that can communicate across different platforms and frameworks.
+A Python SDK that enables seamless integration of various agent frameworks (n8n, LangGraph, CrewAI, LangChain, etc.) and personal AI agents (OpenClaw) with the [A2A (Agent-to-Agent) Protocol](https://github.com/a2aproject/A2A). Build interoperable AI agent systems that can communicate across different platforms and frameworks.
 
 **✨ Key Benefits:**
 
@@ -67,7 +67,7 @@ A Python SDK that enables seamless integration of various agent frameworks (n8n,
 
 ## Features
 
-✨ **Framework Agnostic**: Integrate n8n workflows, LangGraph workflows, CrewAI crews, LangChain chains, and more
+✨ **Framework Agnostic**: Integrate n8n workflows, LangGraph workflows, CrewAI crews, LangChain chains, OpenClaw personal agents, and more
 🔌 **Simple API**: 3-line setup to expose any agent as A2A-compliant
 🌊 **Streaming Support**: Built-in streaming for LangGraph, LangChain, and custom adapters
 🎯 **Type Safe**: Leverages official A2A SDK types
@@ -88,12 +88,13 @@ A Python SDK that enables seamless integration of various agent frameworks (n8n,
 │   - LangGraph   │
 │   - CrewAI      │
 │   - LangChain   │
+│   - OpenClaw    │
 │   - Callable    │
 └────────┬────────┘
          │
          ▼
 ┌─────────────────┐
-│  Your Agent     │  (n8n workflow / CrewAI crew / Chain)
+│  Your Agent     │  (n8n workflow / CrewAI crew / Chain / OpenClaw)
 └─────────────────┘
 ```
 
@@ -226,6 +227,16 @@ adapter = await load_a2a_agent({
 })
 ```
 
+### OpenClaw Agent → A2A Agent
+
+```python
+adapter = await load_a2a_agent({
+    "adapter": "openclaw",
+    "thinking": "low",
+    "async_mode": True
+})
+```
+
 📚 **[View all examples →](https://github.com/hybroai/a2a-adapter/tree/main/examples/)**
 
 ## Advanced Usage
@@ -397,6 +408,19 @@ See [examples/06_langgraph_single_agent.py](https://github.com/hybroai/a2a-adapt
 }
 ```
 
+### OpenClaw Adapter
+
+```python
+{
+    "adapter": "openclaw",
+    "session_id": "my-session",      # Optional, auto-generated if not provided
+    "agent_id": None,                # Optional, use default agent
+    "thinking": "low",               # Optional: off|minimal|low|medium|high|xhigh
+    "timeout": 600,                  # Optional, command timeout in seconds
+    "async_mode": True               # Optional, return Task immediately (default: True)
+}
+```
+
 ## Examples
 
 The `examples/` directory contains complete working examples:
@@ -408,6 +432,7 @@ The `examples/` directory contains complete working examples:
 - **05_custom_adapter.py** - Custom adapter implementations
 - **06_langgraph_single_agent.py** - Calling A2A agents from LangGraph
 - **07_langgraph_server.py** - LangGraph workflow as A2A server
+- **08_openclaw_agent.py** - OpenClaw personal AI agent
 
 Run any example:
 
@@ -511,15 +536,16 @@ Convert framework output to A2A Message or Task.
 
 Check if this adapter supports streaming responses.
 
-## Framework Support
+## Adapter Support
 
-| Framework     | Adapter                  | Non-Streaming | Streaming | Async Tasks | Status    |
-| ------------- | ------------------------ | ------------- | --------- | ----------- | --------- |
-| **n8n**       | `N8nAgentAdapter`        | ✅            | ❌        | ✅          | ✅ Stable |
-| **LangGraph** | `LangGraphAgentAdapter`  | ✅            | ✅        | ✅          | ✅ Stable |
-| **CrewAI**    | `CrewAIAgentAdapter`     | ✅            | ❌        | ✅          | ✅ Stable |
-| **LangChain** | `LangChainAgentAdapter`  | ✅            | ✅        | ❌          | ✅ Stable |
-| **Callable**  | `CallableAgentAdapter`   | ✅            | ✅        | ❌          | ✅ Stable |
+| Agent/Framework | Adapter                  | Non-Streaming | Streaming | Async Tasks | Status    |
+| --------------- | ------------------------ | ------------- | --------- | ----------- | --------- |
+| **n8n**         | `N8nAgentAdapter`        | ✅            | ❌        | ✅          | ✅ Stable |
+| **LangGraph**   | `LangGraphAgentAdapter`  | ✅            | ✅        | ✅          | ✅ Stable |
+| **CrewAI**      | `CrewAIAgentAdapter`     | ✅            | ❌        | ✅          | ✅ Stable |
+| **LangChain**   | `LangChainAgentAdapter`  | ✅            | ✅        | ❌          | ✅ Stable |
+| **OpenClaw**    | `OpenClawAgentAdapter`   | ✅            | ❌        | ✅          | ✅ Stable |
+| **Callable**    | `CallableAgentAdapter`   | ✅            | ✅        | ❌          | ✅ Stable |
 
 ## 🤝 Contributing
 
@@ -551,6 +577,7 @@ We welcome contributions from the community! Whether you're fixing bugs, adding
 - [x] CrewAI adapter (with async task support)
 - [x] LangChain adapter (with streaming)
 - [x] Callable adapter (with streaming)
+- [x] OpenClaw adapter (with async tasks)
 - [x] Comprehensive examples
 - [x] Task support (async execution pattern)
 - [ ] Artifact support (file uploads/downloads)

{a2a_adapter-0.1.4 → a2a_adapter-0.1.5}/README.md

@@ -7,7 +7,7 @@
 
 **🚀 Open Source A2A Protocol Adapter SDK - Make Any Agent Framework A2A-Compatible in 3 Lines**
 
-A Python SDK that enables seamless integration of various agent frameworks (n8n, LangGraph, CrewAI, LangChain, etc.) with the [A2A (Agent-to-Agent) Protocol](https://github.com/a2aproject/A2A). Build interoperable AI agent systems that can communicate across different platforms and frameworks.
+A Python SDK that enables seamless integration of various agent frameworks (n8n, LangGraph, CrewAI, LangChain, etc.) and personal AI agents (OpenClaw) with the [A2A (Agent-to-Agent) Protocol](https://github.com/a2aproject/A2A). Build interoperable AI agent systems that can communicate across different platforms and frameworks.
 
 **✨ Key Benefits:**
 
@@ -22,7 +22,7 @@ A Python SDK that enables seamless integration of various agent frameworks (n8n,
 
 ## Features
 
-✨ **Framework Agnostic**: Integrate n8n workflows, LangGraph workflows, CrewAI crews, LangChain chains, and more
+✨ **Framework Agnostic**: Integrate n8n workflows, LangGraph workflows, CrewAI crews, LangChain chains, OpenClaw personal agents, and more
 🔌 **Simple API**: 3-line setup to expose any agent as A2A-compliant
 🌊 **Streaming Support**: Built-in streaming for LangGraph, LangChain, and custom adapters
 🎯 **Type Safe**: Leverages official A2A SDK types
@@ -43,12 +43,13 @@ A Python SDK that enables seamless integration of various agent frameworks (n8n,
 │   - LangGraph   │
 │   - CrewAI      │
 │   - LangChain   │
+│   - OpenClaw    │
 │   - Callable    │
 └────────┬────────┘
          │
          ▼
 ┌─────────────────┐
-│  Your Agent     │  (n8n workflow / CrewAI crew / Chain)
+│  Your Agent     │  (n8n workflow / CrewAI crew / Chain / OpenClaw)
 └─────────────────┘
 ```
 
@@ -181,6 +182,16 @@ adapter = await load_a2a_agent({
 })
 ```
 
+### OpenClaw Agent → A2A Agent
+
+```python
+adapter = await load_a2a_agent({
+    "adapter": "openclaw",
+    "thinking": "low",
+    "async_mode": True
+})
+```
+
 📚 **[View all examples →](https://github.com/hybroai/a2a-adapter/tree/main/examples/)**
 
 ## Advanced Usage
@@ -352,6 +363,19 @@ See [examples/06_langgraph_single_agent.py](https://github.com/hybroai/a2a-adapt
 }
 ```
 
+### OpenClaw Adapter
+
+```python
+{
+    "adapter": "openclaw",
+    "session_id": "my-session",      # Optional, auto-generated if not provided
+    "agent_id": None,                # Optional, use default agent
+    "thinking": "low",               # Optional: off|minimal|low|medium|high|xhigh
+    "timeout": 600,                  # Optional, command timeout in seconds
+    "async_mode": True               # Optional, return Task immediately (default: True)
+}
+```
+
 ## Examples
 
 The `examples/` directory contains complete working examples:
@@ -363,6 +387,7 @@ The `examples/` directory contains complete working examples:
 - **05_custom_adapter.py** - Custom adapter implementations
 - **06_langgraph_single_agent.py** - Calling A2A agents from LangGraph
 - **07_langgraph_server.py** - LangGraph workflow as A2A server
+- **08_openclaw_agent.py** - OpenClaw personal AI agent
 
 Run any example:
 
@@ -466,15 +491,16 @@ Convert framework output to A2A Message or Task.
 
 Check if this adapter supports streaming responses.
 
-## Framework Support
+## Adapter Support
 
-| Framework     | Adapter                  | Non-Streaming | Streaming | Async Tasks | Status    |
-| ------------- | ------------------------ | ------------- | --------- | ----------- | --------- |
-| **n8n**       | `N8nAgentAdapter`        | ✅            | ❌        | ✅          | ✅ Stable |
-| **LangGraph** | `LangGraphAgentAdapter`  | ✅            | ✅        | ✅          | ✅ Stable |
-| **CrewAI**    | `CrewAIAgentAdapter`     | ✅            | ❌        | ✅          | ✅ Stable |
-| **LangChain** | `LangChainAgentAdapter`  | ✅            | ✅        | ❌          | ✅ Stable |
-| **Callable**  | `CallableAgentAdapter`   | ✅            | ✅        | ❌          | ✅ Stable |
+| Agent/Framework | Adapter                  | Non-Streaming | Streaming | Async Tasks | Status    |
+| --------------- | ------------------------ | ------------- | --------- | ----------- | --------- |
+| **n8n**         | `N8nAgentAdapter`        | ✅            | ❌        | ✅          | ✅ Stable |
+| **LangGraph**   | `LangGraphAgentAdapter`  | ✅            | ✅        | ✅          | ✅ Stable |
+| **CrewAI**      | `CrewAIAgentAdapter`     | ✅            | ❌        | ✅          | ✅ Stable |
+| **LangChain**   | `LangChainAgentAdapter`  | ✅            | ✅        | ❌          | ✅ Stable |
+| **OpenClaw**    | `OpenClawAgentAdapter`   | ✅            | ❌        | ✅          | ✅ Stable |
+| **Callable**    | `CallableAgentAdapter`   | ✅            | ✅        | ❌          | ✅ Stable |
 
 ## 🤝 Contributing
 
@@ -506,6 +532,7 @@ We welcome contributions from the community! Whether you're fixing bugs, adding
 - [x] CrewAI adapter (with async task support)
 - [x] LangChain adapter (with streaming)
 - [x] Callable adapter (with streaming)
+- [x] OpenClaw adapter (with async tasks)
 - [x] Comprehensive examples
 - [x] Task support (async execution pattern)
 - [ ] Artifact support (file uploads/downloads)

{a2a_adapter-0.1.4 → a2a_adapter-0.1.5}/a2a_adapter/__init__.py

@@ -26,7 +26,7 @@ Example:
     >>> asyncio.run(main())
 """
 
-__version__ = "0.1.4"
+__version__ = "0.1.5"
 
 from .adapter import BaseAgentAdapter
 from .client import build_agent_app, serve_agent

{a2a_adapter-0.1.4 → a2a_adapter-0.1.5}/a2a_adapter/client.py

@@ -27,6 +27,7 @@ from a2a.types import (
     ListTaskPushNotificationConfigResponse,
     Message,
     MessageSendParams,
+    PushNotificationConfig,
     SetTaskPushNotificationConfigRequest,
     SetTaskPushNotificationConfigResponse,
     Task,
@@ -43,6 +44,11 @@ class AdapterRequestHandler(RequestHandler):
     
     This class bridges the gap between our adapter abstraction and the
     official A2A SDK's RequestHandler protocol.
+    
+    Supports:
+    - Basic message send (sync and async)
+    - Task get/cancel for async adapters
+    - Push notification configuration for adapters that support it
     """
 
     def __init__(self, adapter: BaseAgentAdapter):
@@ -89,23 +95,37 @@ class AdapterRequestHandler(RequestHandler):
         async for event in self.adapter.handle_stream(params):
             yield event
 
-    # Task-related methods (not supported by default)
+    # Task-related methods
     
     async def on_get_task(
         self,
         params: GetTaskRequest,
         context: ServerCallContext
     ) -> GetTaskResponse:
-        """Get task status - not supported."""
-        raise ServerError(error=UnsupportedOperationError())
+        """Get task status."""
+        if not self.adapter.supports_async_tasks():
+            raise ServerError(error=UnsupportedOperationError())
+        
+        task = await self.adapter.get_task(params.id)
+        if task is None:
+            raise ServerError(error=UnsupportedOperationError(message=f"Task {params.id} not found"))
+        
+        return GetTaskResponse(result=task)
 
     async def on_cancel_task(
         self,
         params: CancelTaskRequest,
         context: ServerCallContext
     ) -> CancelTaskResponse:
-        """Cancel task - not supported."""
-        raise ServerError(error=UnsupportedOperationError())
+        """Cancel task."""
+        if not self.adapter.supports_async_tasks():
+            raise ServerError(error=UnsupportedOperationError())
+        
+        task = await self.adapter.cancel_task(params.id)
+        if task is None:
+            raise ServerError(error=UnsupportedOperationError(message=f"Task {params.id} not found"))
+        
+        return CancelTaskResponse(result=task)
 
     async def on_resubscribe_to_task(
         self,
@@ -116,30 +136,47 @@ class AdapterRequestHandler(RequestHandler):
         raise ServerError(error=UnsupportedOperationError())
         yield  # Make this an async generator
 
-    # Push notification methods (not supported by default)
+    # Push notification methods
     
     async def on_set_task_push_notification_config(
         self,
         params: SetTaskPushNotificationConfigRequest,
         context: ServerCallContext
     ) -> SetTaskPushNotificationConfigResponse:
-        """Set push notification config - not supported."""
-        raise ServerError(error=UnsupportedOperationError())
+        """Set push notification config."""
+        if not hasattr(self.adapter, 'supports_push_notifications') or not self.adapter.supports_push_notifications():
+            raise ServerError(error=UnsupportedOperationError())
+        
+        success = await self.adapter.set_push_notification_config(
+            params.taskId,
+            params.pushNotificationConfig
+        )
+        if not success:
+            raise ServerError(error=UnsupportedOperationError(message=f"Task {params.taskId} not found"))
+        
+        return SetTaskPushNotificationConfigResponse(result=params.pushNotificationConfig)
 
     async def on_get_task_push_notification_config(
         self,
         params: GetTaskPushNotificationConfigParams,
         context: ServerCallContext
     ) -> GetTaskPushNotificationConfigResponse:
-        """Get push notification config - not supported."""
-        raise ServerError(error=UnsupportedOperationError())
+        """Get push notification config."""
+        if not hasattr(self.adapter, 'supports_push_notifications') or not self.adapter.supports_push_notifications():
+            raise ServerError(error=UnsupportedOperationError())
+        
+        config = await self.adapter.get_push_notification_config(params.taskId)
+        if config is None:
+            raise ServerError(error=UnsupportedOperationError(message=f"No push config for task {params.taskId}"))
+        
+        return GetTaskPushNotificationConfigResponse(result=config)
 
     async def on_list_task_push_notification_config(
         self,
         params: ListTaskPushNotificationConfigParams,
         context: ServerCallContext
     ) -> ListTaskPushNotificationConfigResponse:
-        """List push notification configs - not supported."""
+        """List push notification configs - not supported (would need to track all configs)."""
         raise ServerError(error=UnsupportedOperationError())
 
     async def on_delete_task_push_notification_config(
@@ -147,8 +184,15 @@ class AdapterRequestHandler(RequestHandler):
         params: DeleteTaskPushNotificationConfigParams,
         context: ServerCallContext
     ) -> DeleteTaskPushNotificationConfigResponse:
-        """Delete push notification config - not supported."""
-        raise ServerError(error=UnsupportedOperationError())
+        """Delete push notification config."""
+        if not hasattr(self.adapter, 'supports_push_notifications') or not self.adapter.supports_push_notifications():
+            raise ServerError(error=UnsupportedOperationError())
+        
+        success = await self.adapter.delete_push_notification_config(params.taskId)
+        if not success:
+            raise ServerError(error=UnsupportedOperationError(message=f"No push config for task {params.taskId}"))
+        
+        return DeleteTaskPushNotificationConfigResponse(result={})
 
 
 def build_agent_app(

{a2a_adapter-0.1.4 → a2a_adapter-0.1.5}/a2a_adapter/integrations/__init__.py

@@ -7,6 +7,7 @@ This package contains concrete adapter implementations for various agent framewo
 - LangChain: LLM application framework with LCEL support
 - LangGraph: Stateful workflow orchestration framework
 - Callable: Generic Python async function adapter
+- OpenClaw: Personal AI super agent CLI wrapper
 """
 
 __all__ = [
@@ -15,6 +16,7 @@ __all__ = [
     "LangChainAgentAdapter",
     "LangGraphAgentAdapter",
     "CallableAgentAdapter",
+    "OpenClawAgentAdapter",
 ]
 
 # Lazy imports to avoid requiring all optional dependencies
@@ -34,4 +36,7 @@ def __getattr__(name: str):
     elif name == "CallableAgentAdapter":
         from .callable import CallableAgentAdapter
         return CallableAgentAdapter
+    elif name == "OpenClawAgentAdapter":
+        from .openclaw import OpenClawAgentAdapter
+        return OpenClawAgentAdapter
     raise AttributeError(f"module {__name__!r} has no attribute {name!r}")