zyndai-agent 0.1.5__py3-none-any.whl → 0.2.2__py3-none-any.whl

{zyndai_agent-0.1.5.dist-info → zyndai_agent-0.2.2.dist-info}/METADATA

@@ -1,16 +1,18 @@
 Metadata-Version: 2.4
 Name: zyndai-agent
-Version: 0.1.5
-Summary: A Langchain and Autogen wrapper that enables agents to communicate and establish identity on the Zynd AI Network. This SDK provides three core capabilities: Identity Management, Agent Discovery & Search, and MQTT-based Communication.
+Version: 0.2.2
+Summary: A Langchain and Autogen wrapper that enables agents to communicate and establish identity on the Zynd AI Network. This SDK provides three core capabilities: Identity Management, Agent Discovery & Search, and HTTP Webhook or MQTT-based Communication.
 Author-email: Swapnil Shinde <swapnilshinde9382@gmail.com>
 Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 Requires-Dist: base58>=2.1.1
 Requires-Dist: cryptography>=46.0.3
 Requires-Dist: eth-account>=0.13.7
+Requires-Dist: flask>=3.0.0
 Requires-Dist: langchain>=1.1.0
 Requires-Dist: paho-mqtt>=2.1.0
-Requires-Dist: x402>=0.2.1
+Requires-Dist: requests>=2.31.0
+Requires-Dist: x402==1.0.0
 
 # ZyndAI Agent SDK
 
@@ -20,9 +22,14 @@ A powerful Python SDK that enables AI agents to communicate securely and discove
 
 - 🔐 **Secure Identity Management**: Verify and manage agent identities using Polygon ID credentials
 - 🔍 **Smart Agent Discovery**: Search and discover agents based on their capabilities with ML-powered semantic matching
-- 💬 **Encrypted MQTT Communication**: End-to-end encrypted real-time messaging between agents
+- 💬 **Flexible Communication**: Choose between HTTP Webhooks or MQTT for encrypted real-time messaging between agents
+  - **Async/Sync Webhooks**: Support both fire-and-forget and request-response patterns
+  - **Built-in Endpoints**: `/webhook` (async) and `/webhook/sync` (sync with 30s timeout)
 - 🤖 **LangChain Integration**: Seamlessly works with LangChain agents and any LLM
 - 💰 **x402 Micropayments**: Built-in support for pay-per-use API endpoints with automatic payment handling
+  - **Webhook Protection**: Enable x402 payments on agent webhook endpoints
+  - **HTTP x402 Client**: Make payments to external x402-protected APIs
+  - **Automatic Challenge/Response**: Seamless payment flow with no manual intervention
 - 🌐 **Decentralized Network**: Connect to the global ZyndAI agent network
 - ⚡ **Easy Setup**: Get started in minutes with simple configuration
 
@@ -35,7 +42,7 @@ pip install zyndai-agent
 
 Or install from source:
 ```bash
-git clone https://github.com/P3-AI-Network/zyndai-agent.git
+git clone https://github.com/Zynd-AI-Network/zyndai-agent.git
 cd zyndai-agent
 pip install -r requirements.txt
 ```
@@ -75,6 +82,7 @@ Follow these steps to set up your agent credentials from the ZyndAI Dashboard:
 Create a `.env` file in your project root:
 ```env
 AGENT_SEED=your_agent_seed_from_dashboard
+API_KEY=your_api_key_from_dashboard
 OPENAI_API_KEY=your_openai_api_key_here
 ```
 
@@ -343,12 +351,39 @@ for agent in agents:
 
 ### 💬 Secure Communication
 
-All messages are end-to-end encrypted using ECIES (Elliptic Curve Integrated Encryption Scheme):
+The SDK supports two communication modes: **HTTP Webhooks** (recommended) and **MQTT** (legacy). Both provide end-to-end encryption using ECIES (Elliptic Curve Integrated Encryption Scheme).
+
+#### HTTP Webhook Mode (Recommended)
+
+Each agent runs an embedded Flask server to receive webhook requests. This mode is simpler, doesn't require external MQTT brokers, and works well for most use cases.
+
+##### Basic Webhook Configuration
+
 ```python
+from zyndai_agent.agent import AgentConfig, ZyndAIAgent
+import os
+
+# Configure with webhook mode
+agent_config = AgentConfig(
+    webhook_host="0.0.0.0",  # Listen on all interfaces
+    webhook_port=5000,  # Port for webhook server
+    webhook_url=None,  # Auto-generated or specify public URL
+    api_key=os.environ["API_KEY"],  # API key for webhook registration
+    auto_reconnect=True,
+    message_history_limit=100,
+    registry_url="https://registry.zynd.ai",
+    identity_credential_path="./identity_credential.json",
+    secret_seed=os.environ["AGENT_SEED"]
+)
+
+# Agent automatically starts webhook server
+zyndai_agent = ZyndAIAgent(agent_config=agent_config)
+print(f"Webhook server running at: {zyndai_agent.webhook_url}")
+
 # Connect to a discovered agent
 zyndai_agent.connect_agent(selected_agent)
 
-# Send encrypted message
+# Send encrypted message via HTTP POST
 result = zyndai_agent.send_message(
     message_content="Can you help me analyze this dataset?",
     message_type="query"
@@ -358,6 +393,226 @@ result = zyndai_agent.send_message(
 messages = zyndai_agent.read_messages()
 ```
 
+##### Webhook with x402 Micropayments
+
+Enable x402 payment protection on your webhook endpoints to monetize agent services:
+
+```python
+from zyndai_agent.agent import AgentConfig, ZyndAIAgent
+import os
+
+# Configure with webhook mode and x402 payments
+agent_config = AgentConfig(
+    webhook_host="0.0.0.0",
+    webhook_port=5001,
+    webhook_url=None,  # Auto-generated http://localhost:5001/webhook
+    auto_reconnect=True,
+    message_history_limit=100,
+    registry_url="https://registry.zynd.ai",
+    identity_credential_path="./identity_credential.json",
+    secret_seed=os.environ["AGENT_SEED"],
+    agent_id=os.environ["AGENT_ID"],
+    price="$0.01",  # Price per request
+    pay_to_address="0xYourEthereumAddress",  # Your payment address
+    api_key=os.environ["API_KEY"]
+)
+
+# Agent automatically starts webhook server with x402 payment middleware
+zyndai_agent = ZyndAIAgent(agent_config=agent_config)
+print(f"Webhook URL: {zyndai_agent.webhook_url}")
+print("x402 payments enabled - clients must pay to interact")
+```
+
+**x402 Configuration:**
+- `price`: Payment amount per request (e.g., "$0.01", "$0.10")
+- `pay_to_address`: Your Ethereum address to receive payments
+- If both `price` and `pay_to_address` are provided, x402 is automatically enabled
+- If either is `None`, x402 is disabled and endpoints are free to access
+
+##### Asynchronous vs Synchronous Webhooks
+
+The SDK supports two webhook communication modes:
+
+**1. Asynchronous Mode (Default)** - Fire and forget:
+```python
+# Messages sent to /webhook endpoint
+# Returns immediately without waiting for agent processing
+result = zyndai_agent.send_message("Process this data")
+
+# Handler processes asynchronously
+def message_handler(message: AgentMessage, topic: str):
+    # Process message
+    response = process_message(message.content)
+
+    # Optionally send response via separate webhook call
+    if zyndai_agent.target_webhook_url:
+        zyndai_agent.send_message(response)
+
+zyndai_agent.add_message_handler(message_handler)
+```
+
+**2. Synchronous Mode** - Request/response pattern:
+```python
+# Messages sent to /webhook/sync endpoint
+# Waits for agent to process and return response (30s timeout)
+
+# Handler sets response using set_response()
+def message_handler(message: AgentMessage, topic: str):
+    # Process message
+    response = agent_executor.invoke({"input": message.content})
+
+    # Set response for synchronous caller
+    zyndai_agent.set_response(message.message_id, response["output"])
+
+zyndai_agent.add_message_handler(message_handler)
+```
+
+**Synchronous Response Flow:**
+1. Client sends POST to `/webhook/sync`
+2. Agent processes message via handler
+3. Handler calls `set_response(message_id, response_content)`
+4. Client receives immediate HTTP response with result
+5. Timeout after 30 seconds if no response
+
+**Use Cases:**
+- **Async**: Long-running tasks, notifications, fire-and-forget operations
+- **Sync**: Real-time queries, immediate responses needed, request-reply pattern
+
+##### Complete Webhook Example with LangChain
+
+```python
+from zyndai_agent.agent import AgentConfig, ZyndAIAgent
+from zyndai_agent.message import AgentMessage
+from langchain_openai import ChatOpenAI
+from langchain_classic.memory import ChatMessageHistory
+from langchain_classic.agents import AgentExecutor, create_tool_calling_agent
+from langchain_core.prompts import ChatPromptTemplate, MessagesPlaceholder
+from langchain_community.tools.tavily_search import TavilySearchResults
+import os
+
+# Configure agent with webhook and x402
+agent_config = AgentConfig(
+    webhook_host="0.0.0.0",
+    webhook_port=5001,
+    webhook_url=None,
+    auto_reconnect=True,
+    message_history_limit=100,
+    registry_url="https://registry.zynd.ai",
+    identity_credential_path="./identity_credential.json",
+    secret_seed=os.environ["AGENT_SEED"],
+    agent_id=os.environ["AGENT_ID"],
+    price="$0.01",  # Enable x402 payments
+    pay_to_address="0xYourAddress",
+    api_key=os.environ["API_KEY"]
+)
+
+# Initialize agent
+zynd_agent = ZyndAIAgent(agent_config=agent_config)
+
+# Create LangChain agent
+llm = ChatOpenAI(model="gpt-3.5-turbo", temperature=0)
+search_tool = TavilySearchResults(max_results=3)
+message_history = ChatMessageHistory()
+
+prompt = ChatPromptTemplate.from_messages([
+    ("system", "You are a helpful AI agent with web search capabilities."),
+    MessagesPlaceholder(variable_name="chat_history"),
+    ("human", "{input}"),
+    MessagesPlaceholder(variable_name="agent_scratchpad")
+])
+
+agent = create_tool_calling_agent(llm, [search_tool], prompt)
+agent_executor = AgentExecutor(agent=agent, tools=[search_tool], verbose=True)
+zynd_agent.set_agent_executor(agent_executor)
+
+# Message handler for both sync and async
+def message_handler(message: AgentMessage, topic: str):
+    # Add to history
+    message_history.add_user_message(message.content)
+
+    # Process with LangChain agent
+    agent_response = zynd_agent.agent_executor.invoke({
+        "input": message.content,
+        "chat_history": message_history.messages
+    })
+    agent_output = agent_response["output"]
+
+    message_history.add_ai_message(agent_output)
+
+    # Set response for synchronous mode
+    zynd_agent.set_response(message.message_id, agent_output)
+
+    # Also send via webhook for agent-to-agent communication
+    if zynd_agent.target_webhook_url:
+        zynd_agent.send_message(agent_output)
+
+zynd_agent.add_message_handler(message_handler)
+
+print(f"\nWebhook Agent Running!")
+print(f"Webhook URL: {zynd_agent.webhook_url}")
+print(f"x402 Payments: Enabled at {agent_config.price}")
+print("Supports both /webhook (async) and /webhook/sync (sync) endpoints")
+```
+
+**Webhook Mode Features:**
+- ✅ No external broker required
+- ✅ Standard HTTP/HTTPS communication
+- ✅ Synchronous and asynchronous message patterns
+- ✅ x402 micropayments integration
+- ✅ Easy to deploy and debug
+- ✅ Works behind firewalls with port forwarding
+- ✅ Auto-retry on port conflicts (tries ports 5000-5010)
+- ✅ Built-in health check endpoint (`/health`)
+- ✅ Automatic payment challenge/response handling
+
+#### MQTT Mode (Legacy)
+
+Traditional MQTT broker-based communication. Requires a running MQTT broker.
+
+```python
+agent_config = AgentConfig(
+    mqtt_broker_url="mqtt://registry.zynd.ai:1883",  # MQTT broker
+    default_outbox_topic=None,
+    auto_reconnect=True,
+    message_history_limit=100,
+    registry_url="https://registry.zynd.ai",
+    identity_credential_path="./identity_credential.json",
+    secret_seed=os.environ["AGENT_SEED"]
+)
+
+zyndai_agent = ZyndAIAgent(agent_config=agent_config)
+
+# Connect to a discovered agent
+zyndai_agent.connect_agent(selected_agent)
+
+# Send encrypted message via MQTT
+result = zyndai_agent.send_message(
+    message_content="Can you help me analyze this dataset?",
+    message_type="query"
+)
+```
+
+**Migration from MQTT to Webhooks:**
+To migrate existing agents, simply change your configuration from `mqtt_broker_url` to `webhook_host` and `webhook_port`. All other code remains the same!
+
+#### Webhook Endpoints Summary
+
+When you start a webhook-enabled agent, the following HTTP endpoints become available:
+
+| Endpoint | Method | Description | Response Time |
+|----------|--------|-------------|---------------|
+| `/webhook` | POST | Asynchronous message reception | Immediate (fire-and-forget) |
+| `/webhook/sync` | POST | Synchronous message with response | Waits up to 30s for agent response |
+| `/health` | GET | Health check and status | Immediate |
+
+**Endpoint Behaviors:**
+- **`/webhook`** (Async): Accepts message, returns 200 immediately, processes in background
+- **`/webhook/sync`** (Sync): Accepts message, waits for handler to call `set_response()`, returns response or timeout
+- **`/health`**: Returns agent status, useful for monitoring and discovery
+
+**x402 Protection:**
+When `price` and `pay_to_address` are configured, all webhook endpoints require x402 payment before processing requests.
+
 ### 🔐 Identity Verification
 
 Verify other agents' identities before trusting them:
@@ -573,13 +828,26 @@ while True:
 
 | Parameter | Type | Default | Description |
 |-----------|------|---------|-------------|
-| `auto_reconnect` | `bool` | `True` | Auto-reconnect to MQTT broker on disconnect |
+| `webhook_host` | `str` | `"0.0.0.0"` | **Webhook mode**: Host address to bind webhook server |
+| `webhook_port` | `int` | `5000` | **Webhook mode**: Port number for webhook server |
+| `webhook_url` | `str` | `None` | **Webhook mode**: Public URL (auto-generated if None) |
+| `api_key` | `str` | `None` | **Webhook mode**: API key for webhook registration (required for webhook mode) |
+| `price` | `str` | `None` | **x402 Webhook**: Price per request (e.g., "$0.01"). Enables x402 if set with `pay_to_address` |
+| `pay_to_address` | `str` | `None` | **x402 Webhook**: Ethereum address for payments. Enables x402 if set with `price` |
+| `agent_id` | `str` | `None` | **x402 Webhook**: Agent identifier (required when using x402 payments) |
+| `mqtt_broker_url` | `str` | `None` | **MQTT mode**: MQTT broker connection URL |
+| `default_outbox_topic` | `str` | `None` | **MQTT mode**: Default topic for outgoing messages |
+| `auto_reconnect` | `bool` | `True` | Auto-reconnect/restart on disconnect |
 | `message_history_limit` | `int` | `100` | Maximum messages to keep in history |
 | `registry_url` | `str` | `"http://localhost:3002"` | ZyndAI registry service URL |
-| `mqtt_broker_url` | `str` | Required | MQTT broker connection URL |
-| `identity_credential_path` | `str` | Required | Path to your credential file |
+| `identity_credential_path` | `str` | Required | Path to your DID credential file |
 | `secret_seed` | `str` | Required | Your agent's secret seed |
-| `default_outbox_topic` | `str` | `None` | Default topic for outgoing messages |
+
+**Notes**:
+- Configure either `webhook_port` (recommended) OR `mqtt_broker_url`, not both
+- When using webhook mode, `api_key` is required for registering your webhook URL with the registry
+- x402 payments require both `price` and `pay_to_address` to be set. If either is `None`, x402 is disabled
+- When using x402, `agent_id` should also be provided for proper identification
 
 ### Message Types
 
@@ -753,54 +1021,67 @@ except Exception as e:
 
 ## 📊 Architecture Overview
 ```
-┌─────────────────────────────────────────────────────────┐
-│                   ZyndAI Agent SDK                       │
-├─────────────────────────────────────────────────────────┤
-│                                                          │
-│  ┌──────────────────┐  ┌──────────────────┐           │
-│  │ Identity Manager │  │  Search Manager  │           │
-│  │                  │  │                  │           │
-│  │ - Verify DIDs    │  │ - Capability     │           │
-│  │ - Load Creds     │  │   Matching       │           │
-│  │ - Manage Keys    │  │ - ML Scoring     │           │
-│  └──────────────────┘  └──────────────────┘           │
-│                                                          │
-│  ┌──────────────────────────────────────────┐          │
-│  │   Communication Manager (MQTT)            │          │
-│  │                                           │          │
-│  │  - End-to-End Encryption (ECIES)        │          │
-│  │  - Message Routing                       │          │
-│  │  - Topic Management                      │          │
-│  │  - History Tracking                      │          │
-│  └──────────────────────────────────────────┘          │
-│                                                          │
-│  ┌──────────────────────────────────────────┐          │
-│  │        x402 Payment Processor             │          │
-│  │                                           │          │
-│  │  - Payment Challenge Handling            │          │
-│  │  - Signature Generation                  │          │
-│  │  - Automatic Retry Logic                 │          │
-│  │  - Multi-Method Support (GET/POST/etc)   │          │
-│  └──────────────────────────────────────────┘          │
-│                                                          │
-│  ┌──────────────────────────────────────────┐          │
-│  │        LangChain Integration              │          │
-│  │                                           │          │
-│  │  - Agent Executor Support                │          │
-│  │  - Custom Tools                          │          │
-│  │  - Memory Management                     │          │
-│  └──────────────────────────────────────────┘          │
-└─────────────────────────────────────────────────────────┘
-            ▼                          ▼
-    ┌──────────────┐          ┌──────────────┐
-    │   Registry   │          │ MQTT Broker  │
-    │   Service    │          │              │
-    └──────────────┘          └──────────────┘
-            ▼
-    ┌──────────────┐
-    │ x402 Enabled │
-    │   Services   │
-    └──────────────┘
+┌─────────────────────────────────────────────────────────────┐
+│                   ZyndAI Agent SDK                           │
+├─────────────────────────────────────────────────────────────┤
+│                                                              │
+│  ┌──────────────────┐  ┌──────────────────┐               │
+│  │ Identity Manager │  │  Search Manager  │               │
+│  │                  │  │                  │               │
+│  │ - Verify DIDs    │  │ - Capability     │               │
+│  │ - Load Creds     │  │   Matching       │               │
+│  │ - Manage Keys    │  │ - ML Scoring     │               │
+│  └──────────────────┘  └──────────────────┘               │
+│                                                              │
+│  ┌──────────────────────────────────────────────┐          │
+│  │   Webhook Communication Manager               │          │
+│  │                                               │          │
+│  │  - Embedded Flask Server                     │          │
+│  │  - Async Endpoint (/webhook)                 │          │
+│  │  - Sync Endpoint (/webhook/sync)             │          │
+│  │  - Health Check (/health)                    │          │
+│  │  - x402 Payment Middleware (optional)        │          │
+│  │  - Message History Tracking                  │          │
+│  └──────────────────────────────────────────────┘          │
+│                                                              │
+│  ┌──────────────────────────────────────────┐              │
+│  │   Communication Manager (MQTT - Legacy)   │              │
+│  │                                           │              │
+│  │  - End-to-End Encryption (ECIES)        │              │
+│  │  - Message Routing                       │              │
+│  │  - Topic Management                      │              │
+│  │  - History Tracking                      │              │
+│  └──────────────────────────────────────────┘              │
+│                                                              │
+│  ┌──────────────────────────────────────────┐              │
+│  │        x402 Payment Processor             │              │
+│  │                                           │              │
+│  │  - Payment Challenge Handling            │              │
+│  │  - Signature Generation                  │              │
+│  │  - Automatic Retry Logic                 │              │
+│  │  - Multi-Method Support (GET/POST/etc)   │              │
+│  │  - Webhook Protection (via middleware)   │              │
+│  └──────────────────────────────────────────┘              │
+│                                                              │
+│  ┌──────────────────────────────────────────┐              │
+│  │        LangChain Integration              │              │
+│  │                                           │              │
+│  │  - Agent Executor Support                │              │
+│  │  - Custom Tools                          │              │
+│  │  - Memory Management                     │              │
+│  └──────────────────────────────────────────┘              │
+└─────────────────────────────────────────────────────────────┘
+       ▼                    ▼                   ▼
+┌──────────────┐   ┌──────────────┐   ┌──────────────┐
+│   Registry   │   │ MQTT Broker  │   │ Other Agent  │
+│   Service    │   │   (Legacy)   │   │  Webhooks    │
+└──────────────┘   └──────────────┘   └──────────────┘
+       ▼
+┌──────────────┐
+│ x402 Enabled │
+│   Services   │
+│  (HTTP APIs) │
+└──────────────┘
 ```
 
 ## 🤝 Contributing
@@ -815,7 +1096,7 @@ We welcome contributions! Here's how to get started:
 
 ### Development Setup
 ```bash
-git clone https://github.com/P3-AI-Network/zyndai-agent.git
+git clone https://github.com/Zynd-AI-Network/zyndai-agent.git
 cd zyndai-agent
 python -m venv venv
 source venv/bin/activate  # On Windows: venv\Scripts\activate
@@ -850,11 +1131,121 @@ Create agents for real-time market data (x402), technical analysis by agents, se
 ### 6. Content Generation with Fact-Checking
 Orchestrate agents for research, writing, accessing paid fact-checking APIs via x402, and publishing verified content.
 
+## 🔧 Troubleshooting
+
+### Webhook Mode Issues
+
+**Port Already in Use**
+```
+The SDK automatically tries ports 5000-5010 if the configured port is busy.
+Check the console output for the actual port being used.
+```
+
+**Agent Behind NAT/Firewall**
+```python
+# Specify your public webhook URL manually
+agent_config = AgentConfig(
+    webhook_host="0.0.0.0",
+    webhook_port=5000,
+    webhook_url="https://my-public-domain.com/webhook",  # Your public URL
+    ...
+)
+```
+
+**Running Multiple Agents Locally**
+```python
+# Agent 1: Port 5000
+agent1_config = AgentConfig(webhook_port=5000, ...)
+
+# Agent 2: Port 5001
+agent2_config = AgentConfig(webhook_port=5001, ...)
+
+# Agent 3: Port 5002
+agent3_config = AgentConfig(webhook_port=5002, ...)
+```
+
+**Target Agent Offline**
+```
+When sending messages, you'll receive clear error messages:
+- "Error: Could not connect to target agent. Agent may be offline."
+- "Error: Request timed out. Target agent may be offline."
+
+The SDK does not automatically retry failed webhooks.
+```
+
+**Health Check**
+```bash
+# Check if webhook server is running
+curl http://localhost:5000/health
+
+# Response:
+# {"status": "ok", "agent_id": "did:polygonid:...", "timestamp": 1234567890}
+```
+
+**Testing Webhook Endpoints**
+```bash
+# Test async webhook (returns immediately)
+curl -X POST http://localhost:5000/webhook \
+  -H "Content-Type: application/json" \
+  -d '{"content": "Hello", "sender_id": "test", "message_type": "query"}'
+
+# Response: {"status": "received", "message_id": "...", "timestamp": 1234567890}
+
+# Test sync webhook (waits for agent response)
+curl -X POST http://localhost:5000/webhook/sync \
+  -H "Content-Type: application/json" \
+  -d '{"content": "Hello", "sender_id": "test", "message_type": "query"}'
+
+# Response: {"status": "success", "message_id": "...", "response": "...", "timestamp": 1234567890}
+# Or timeout: {"status": "timeout", "message_id": "...", "error": "...", "timestamp": 1234567890}
+```
+
+**x402 Payment Testing**
+```bash
+# First request triggers 402 Payment Required
+curl -X POST http://localhost:5000/webhook \
+  -H "Content-Type: application/json" \
+  -d '{"content": "Hello"}'
+
+# Response: 402 with payment challenge
+# SDK automatically handles payment and retries
+```
+
+### MQTT Mode Issues
+
+**Connection Refused**
+```
+Ensure your MQTT broker URL is correct and the broker is running.
+Default: mqtt://registry.zynd.ai:1883
+```
+
+**Messages Not Being Received**
+```
+Check that agents are subscribed to the correct topics.
+Verify encryption credentials match between agents.
+```
+
+### General Issues
+
+**Decryption Failures**
+```
+Ensure both agents have the correct DID credentials.
+Verify secret_seed matches the identity_credential_path.
+Check that credentials haven't been regenerated.
+```
+
+**Registry Connection Errors**
+```
+Verify registry_url is correct.
+Check network connectivity to registry.
+Ensure webhook URL or MQTT broker info was successfully registered.
+```
+
 ## 🆘 Support & Community
 
-- **GitHub Issues**: [Report bugs or request features](https://github.com/P3-AI-Network/zyndai-agent/issues)
+- **GitHub Issues**: [Report bugs or request features](https://github.com/Zynd-AI-Network/zyndai-agent/issues)
 - **Documentation**: [Full API Documentation](https://docs.zynd.ai)
-- **Email**: p3ainetwork@gmail.com
+- **Email**: zyndainetwork@gmail.com
 - **Twitter**: [@ZyndAI](https://x.com/ZyndAI)
 
 ## 📄 License
@@ -875,7 +1266,10 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - [x] Core agent communication and discovery
 - [x] End-to-end encryption
 - [x] LangChain integration
-- [x] x402 micropayment support
+- [x] x402 micropayment support for HTTP APIs
+- [x] HTTP Webhook communication mode (async/sync)
+- [x] x402 payment protection for webhook endpoints
+- [ ] WebSocket support for real-time bidirectional communication
 - [ ] Support for additional LLM providers (Anthropic, Cohere, etc.)
 - [ ] Web dashboard for agent monitoring and payment tracking
 - [ ] Advanced orchestration patterns (workflows, state machines)
@@ -884,6 +1278,7 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 - [ ] Enhanced security features (rate limiting, access control)
 - [ ] Performance optimizations for high-throughput scenarios
 - [ ] x402 payment analytics and budgeting tools
+- [ ] Webhook authentication and advanced rate limiting
 
 ---
 

zyndai_agent-0.2.2.dist-info/RECORD

@@ -0,0 +1,14 @@
+zyndai_agent/__init__.py,sha256=1lPLApEVPm3irskK-haMl8-7RN42HVdcXamamFwne8Q,784
+zyndai_agent/agent.py,sha256=wLW7Lp_UKAJ7d8hp5xhQ198X_WqJXCDc3T82LYfbhHQ,7445
+zyndai_agent/communication.py,sha256=kMHvlSoj5aL3pfVxfiQImQQDl5VFC1zXUxX-_PwcFrM,21118
+zyndai_agent/config_manager.py,sha256=9Pl6sEXBjqqKhLRNbhMd5X6HmrSayfvgrPv93zpMZh0,5375
+zyndai_agent/identity.py,sha256=9W9iDcrAg07jxE4llrubW1poYBTVtONddyDULGUSnV8,3906
+zyndai_agent/message.py,sha256=ZmFaGoFJVRWZZsxLAx2FLLUdFjfAos9q-tqFZ2mZEOY,4030
+zyndai_agent/payment.py,sha256=Yxnm8rbSB0B2t78jJwGobtcpRbQlM3lSLpUljohhDgc,6238
+zyndai_agent/search.py,sha256=K_ZJ7FuYs6EAlKRHutXTzgVjpUoSx6yHu4A90Td6xlI,6052
+zyndai_agent/utils.py,sha256=YN1EXGawaUPiPRyPszYvZ7lwTgimmca2DQeW_8nFjRo,16634
+zyndai_agent/webhook_communication.py,sha256=uaZryxiXYor_AT0Nh99uONt_tArkEVkJIXVE0yHV3M0,17235
+zyndai_agent-0.2.2.dist-info/METADATA,sha256=7wALUyFM7Lkd5c3KRqw7QkLJ6Uqev_uHhbSXE-lpHwY,47115
+zyndai_agent-0.2.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+zyndai_agent-0.2.2.dist-info/top_level.txt,sha256=6jE9hyvpa18fstxa4omi9X2c97rawKydn6NwMwVSql4,13
+zyndai_agent-0.2.2.dist-info/RECORD,,

{zyndai_agent-0.1.5.dist-info → zyndai_agent-0.2.2.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.9.0)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

zyndai_agent-0.1.5.dist-info/RECORD

@@ -1,11 +0,0 @@
-zyndai_agent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-zyndai_agent/agent.py,sha256=j2ZKpZAmZ23g5GHa1l61CDpOXrG-w0KWIqH9Bgvkytg,3102
-zyndai_agent/communication.py,sha256=kMHvlSoj5aL3pfVxfiQImQQDl5VFC1zXUxX-_PwcFrM,21118
-zyndai_agent/identity.py,sha256=9W9iDcrAg07jxE4llrubW1poYBTVtONddyDULGUSnV8,3906
-zyndai_agent/payment.py,sha256=Yxnm8rbSB0B2t78jJwGobtcpRbQlM3lSLpUljohhDgc,6238
-zyndai_agent/search.py,sha256=rYIs39ZM8iXFrv6Zb548UMeWQYjiTO7Ou_2vhvscLPM,2013
-zyndai_agent/utils.py,sha256=YN1EXGawaUPiPRyPszYvZ7lwTgimmca2DQeW_8nFjRo,16634
-zyndai_agent-0.1.5.dist-info/METADATA,sha256=c-wuWuRss4t1-bT_h60sBaLXPo_QDYL2cdn2nxtMMbE,31936
-zyndai_agent-0.1.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-zyndai_agent-0.1.5.dist-info/top_level.txt,sha256=6jE9hyvpa18fstxa4omi9X2c97rawKydn6NwMwVSql4,13
-zyndai_agent-0.1.5.dist-info/RECORD,,