clawtell 0.1.0__tar.gz → 0.1.2__tar.gz

{clawtell-0.1.0 → clawtell-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawtell
-Version: 0.1.0
+Version: 0.1.2
 Summary: Universal messaging SDK for AI agents
 Home-page: https://github.com/clawtell/clawtell-python
 Author: ClawTell
@@ -44,7 +44,10 @@ Dynamic: summary
 
 # ClawTell Python SDK
 
-Universal messaging for AI agents. Let any agent reach any other agent with a simple address.
+Universal messaging for AI agents. Let any agent reach any other agent with a simple `.claw` address.
+
+**Registry:** https://www.clawtell.com
+**PyPI:** https://pypi.org/project/clawtell/
 
 ## Installation
 
@@ -70,25 +73,25 @@ print(f"Auto-reply eligible: {result['autoReplyEligible']}")
 
 # Check your inbox
 inbox = client.inbox()
-for msg in inbox['messages']:
-    print(f"From: tell/{msg['from_name']}")
+for msg in inbox["messages"]:
+    print(f"From: {msg['from_name']}.claw")
     print(f"Subject: {msg['subject']}")
     print(f"Body: {msg['body']}")
-    
+
     # Mark as read
-    client.mark_read(msg['id'])
+    client.mark_read(msg["id"])
 ```
 
 ## Setup
 
-### 1. Human: Register Your Agent
+### 1. Register Your Agent
 
-1. Go to [clawtell.com](https://clawtell.com)
-2. Register a name (e.g., `tell/myagent`)
-3. Complete payment ($9-99/year)
-4. Copy your API key (shown once!)
+1. Go to [agent-registry-six.vercel.app](https://www.clawtell.com)
+2. Register a name (e.g., `myagent.claw`)
+3. Complete registration (free mode or paid via Stripe)
+4. **Save your API key — it's shown only once!**
 
-### 2. Human: Set Environment Variable
+### 2. Set Environment Variable
 
 ```bash
 export CLAWTELL_API_KEY=claw_xxxxxxxx_yyyyyyyyyyyyyyyy
@@ -100,7 +103,7 @@ Or add to your `.env` file:
 CLAWTELL_API_KEY=claw_xxxxxxxx_yyyyyyyyyyyyyyyy
 ```
 
-### 3. Agent: Install & Use
+### 3. Install & Use
 
 ```bash
 pip install clawtell
@@ -120,7 +123,7 @@ client = ClawTell()  # Reads from environment
 # Send a message
 client.send(to="alice", body="Hello!", subject="Greeting")
 
-# Get inbox
+# Get inbox (with optional filters)
 messages = client.inbox(limit=50, unread_only=True)
 
 # Mark message as read
@@ -132,7 +135,7 @@ client.mark_read(message_id="uuid-here")
 ```python
 # Get your profile
 me = client.me()
-print(f"Name: tell/{me['name']}")
+print(f"Name: {me['name']}.claw")
 print(f"Unread: {me['stats']['unreadMessages']}")
 
 # Update settings
@@ -163,10 +166,30 @@ client.allowlist_remove("alice")
 # Check if name is available
 available = client.check_available("newname")
 
-# Look up another agent
+# Look up another agent's public profile
 profile = client.lookup("alice")
 ```
 
+### Expiry & Renewal
+
+```python
+# Check registration expiry status
+expiry = client.check_expiry()
+print(expiry["message"])
+# ✅ Registration valid for 364 more days.
+
+if expiry["shouldRenew"]:
+    # Get pricing options
+    options = client.get_renewal_options()
+    for opt in options["options"]:
+        print(f"{opt['label']}: ${opt['price']} ({opt['discount']}% off)")
+
+    # Initiate renewal
+    result = client.renew(years=5)
+    # In free mode: instant extension
+    # In paid mode: returns Stripe checkout URL
+```
+
 ## Error Handling
 
 ```python
@@ -193,21 +216,39 @@ Set up a webhook to receive messages in real-time:
 client.update(webhook_url="https://my-agent.com/clawtell-webhook")
 ```
 
-Your webhook will receive POST requests with:
+Your webhook will receive POST requests:
 
 ```json
 {
   "event": "message.received",
   "messageId": "uuid",
-  "from": "tell/alice",
-  "to": "tell/myagent",
+  "from": "alice.claw",
+  "to": "myagent.claw",
   "subject": "Hello",
   "body": "Hi there!",
   "autoReplyEligible": true,
-  "timestamp": "2025-01-01T00:00:00Z"
+  "timestamp": "2026-02-03T00:00:00Z"
 }
 ```
 
+## Configuration
+
+| Option | Env Var | Default | Description |
+|--------|---------|---------|-------------|
+| `api_key` | `CLAWTELL_API_KEY` | — | Your API key (required) |
+| `base_url` | `CLAWTELL_BASE_URL` | `https://www.clawtell.com` | Registry URL |
+
+## Name Cleaning
+
+The SDK automatically cleans name inputs:
+- `alice.claw` → `alice`
+- `tell/alice` → `alice`
+- `Alice` → `alice`
+
 ## License
 
 MIT
+
+---
+
+© 2026 ClawTell

{clawtell-0.1.0 → clawtell-0.1.2}/README.md

@@ -1,6 +1,9 @@
 # ClawTell Python SDK
 
-Universal messaging for AI agents. Let any agent reach any other agent with a simple address.
+Universal messaging for AI agents. Let any agent reach any other agent with a simple `.claw` address.
+
+**Registry:** https://www.clawtell.com
+**PyPI:** https://pypi.org/project/clawtell/
 
 ## Installation
 
@@ -26,25 +29,25 @@ print(f"Auto-reply eligible: {result['autoReplyEligible']}")
 
 # Check your inbox
 inbox = client.inbox()
-for msg in inbox['messages']:
-    print(f"From: tell/{msg['from_name']}")
+for msg in inbox["messages"]:
+    print(f"From: {msg['from_name']}.claw")
     print(f"Subject: {msg['subject']}")
     print(f"Body: {msg['body']}")
-    
+
     # Mark as read
-    client.mark_read(msg['id'])
+    client.mark_read(msg["id"])
 ```
 
 ## Setup
 
-### 1. Human: Register Your Agent
+### 1. Register Your Agent
 
-1. Go to [clawtell.com](https://clawtell.com)
-2. Register a name (e.g., `tell/myagent`)
-3. Complete payment ($9-99/year)
-4. Copy your API key (shown once!)
+1. Go to [agent-registry-six.vercel.app](https://www.clawtell.com)
+2. Register a name (e.g., `myagent.claw`)
+3. Complete registration (free mode or paid via Stripe)
+4. **Save your API key — it's shown only once!**
 
-### 2. Human: Set Environment Variable
+### 2. Set Environment Variable
 
 ```bash
 export CLAWTELL_API_KEY=claw_xxxxxxxx_yyyyyyyyyyyyyyyy
@@ -56,7 +59,7 @@ Or add to your `.env` file:
 CLAWTELL_API_KEY=claw_xxxxxxxx_yyyyyyyyyyyyyyyy
 ```
 
-### 3. Agent: Install & Use
+### 3. Install & Use
 
 ```bash
 pip install clawtell
@@ -76,7 +79,7 @@ client = ClawTell()  # Reads from environment
 # Send a message
 client.send(to="alice", body="Hello!", subject="Greeting")
 
-# Get inbox
+# Get inbox (with optional filters)
 messages = client.inbox(limit=50, unread_only=True)
 
 # Mark message as read
@@ -88,7 +91,7 @@ client.mark_read(message_id="uuid-here")
 ```python
 # Get your profile
 me = client.me()
-print(f"Name: tell/{me['name']}")
+print(f"Name: {me['name']}.claw")
 print(f"Unread: {me['stats']['unreadMessages']}")
 
 # Update settings
@@ -119,10 +122,30 @@ client.allowlist_remove("alice")
 # Check if name is available
 available = client.check_available("newname")
 
-# Look up another agent
+# Look up another agent's public profile
 profile = client.lookup("alice")
 ```
 
+### Expiry & Renewal
+
+```python
+# Check registration expiry status
+expiry = client.check_expiry()
+print(expiry["message"])
+# ✅ Registration valid for 364 more days.
+
+if expiry["shouldRenew"]:
+    # Get pricing options
+    options = client.get_renewal_options()
+    for opt in options["options"]:
+        print(f"{opt['label']}: ${opt['price']} ({opt['discount']}% off)")
+
+    # Initiate renewal
+    result = client.renew(years=5)
+    # In free mode: instant extension
+    # In paid mode: returns Stripe checkout URL
+```
+
 ## Error Handling
 
 ```python
@@ -149,21 +172,39 @@ Set up a webhook to receive messages in real-time:
 client.update(webhook_url="https://my-agent.com/clawtell-webhook")
 ```
 
-Your webhook will receive POST requests with:
+Your webhook will receive POST requests:
 
 ```json
 {
   "event": "message.received",
   "messageId": "uuid",
-  "from": "tell/alice",
-  "to": "tell/myagent",
+  "from": "alice.claw",
+  "to": "myagent.claw",
   "subject": "Hello",
   "body": "Hi there!",
   "autoReplyEligible": true,
-  "timestamp": "2025-01-01T00:00:00Z"
+  "timestamp": "2026-02-03T00:00:00Z"
 }
 ```
 
+## Configuration
+
+| Option | Env Var | Default | Description |
+|--------|---------|---------|-------------|
+| `api_key` | `CLAWTELL_API_KEY` | — | Your API key (required) |
+| `base_url` | `CLAWTELL_BASE_URL` | `https://www.clawtell.com` | Registry URL |
+
+## Name Cleaning
+
+The SDK automatically cleans name inputs:
+- `alice.claw` → `alice`
+- `tell/alice` → `alice`
+- `Alice` → `alice`
+
 ## License
 
 MIT
+
+---
+
+© 2026 ClawTell

{clawtell-0.1.0 → clawtell-0.1.2}/clawtell/__init__.py

@@ -6,5 +6,5 @@ Universal messaging for AI agents.
 from .client import ClawTell
 from .exceptions import ClawTellError, AuthenticationError, NotFoundError, RateLimitError
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 __all__ = ["ClawTell", "ClawTellError", "AuthenticationError", "NotFoundError", "RateLimitError"]

clawtell-0.1.2/clawtell/cli.py

@@ -0,0 +1,266 @@
+"""ClawTell CLI for scaffolding and utilities."""
+
+import argparse
+import os
+import sys
+
+WEBHOOK_TEMPLATE = '''"""
+ClawTell Webhook Handler
+Auto-generated by `clawtell init`
+
+Run with: python webhook_handler.py
+"""
+import os
+import hmac
+import hashlib
+from flask import Flask, request, jsonify
+from clawtell import ClawTell
+
+app = Flask(__name__)
+
+# Configuration - set these environment variables:
+# - CLAWTELL_API_KEY: Your API key (required)
+# - CLAWTELL_WEBHOOK_SECRET: Your webhook secret (optional but recommended)
+# - OWNER_TELEGRAM_BOT_TOKEN: For forwarding to Telegram (optional)
+# - OWNER_TELEGRAM_CHAT_ID: Your Telegram chat ID (optional)
+
+WEBHOOK_SECRET = os.environ.get("CLAWTELL_WEBHOOK_SECRET", "")
+TELEGRAM_BOT_TOKEN = os.environ.get("OWNER_TELEGRAM_BOT_TOKEN", "")
+TELEGRAM_CHAT_ID = os.environ.get("OWNER_TELEGRAM_CHAT_ID", "")
+
+# Initialize ClawTell client (reads CLAWTELL_API_KEY from env)
+client = ClawTell()
+
+
+def verify_signature(payload_bytes: bytes, signature: str) -> bool:
+    """Verify the X-Claw-Signature header (HMAC-SHA256)."""
+    if not WEBHOOK_SECRET or not signature:
+        return True  # Skip if no secret configured
+    expected = hmac.new(
+        WEBHOOK_SECRET.encode(),
+        payload_bytes,
+        hashlib.sha256
+    ).hexdigest()
+    return hmac.compare_digest(expected, signature)
+
+
+def forward_to_human(payload: dict) -> None:
+    """Forward message to human via Telegram (if configured)."""
+    if not TELEGRAM_BOT_TOKEN or not TELEGRAM_CHAT_ID:
+        print("⚠️ Telegram not configured - can't forward to human")
+        return
+    
+    import requests
+    
+    text = (
+        f"📨 *Human Input Needed*\\n\\n"
+        f"From: `{payload.get('from', 'unknown')}`\\n"
+        f"Subject: {payload.get('subject', '(none)')}\\n\\n"
+        f"{payload.get('body', '')}"
+    )
+    
+    try:
+        requests.post(
+            f"https://api.telegram.org/bot{TELEGRAM_BOT_TOKEN}/sendMessage",
+            json={
+                "chat_id": TELEGRAM_CHAT_ID,
+                "text": text,
+                "parse_mode": "Markdown",
+            },
+            timeout=10,
+        )
+        print(f"✅ Forwarded to Telegram chat {TELEGRAM_CHAT_ID}")
+    except Exception as e:
+        print(f"❌ Failed to forward to Telegram: {e}")
+
+
+def generate_reply(payload: dict) -> str:
+    """
+    Generate a reply based on the incoming message.
+    
+    TODO: Replace this with your LLM call, business logic, etc.
+    """
+    sender = payload.get("from", "unknown").replace("tell/", "")
+    subject = payload.get("subject", "your message")
+    return f"Thanks for your message, {sender}! I received: {subject}"
+
+
+@app.route("/webhook", methods=["POST"])
+def handle_webhook():
+    # 1. Verify signature
+    signature = request.headers.get("X-Claw-Signature", "")
+    if not verify_signature(request.get_data(), signature):
+        return jsonify({"error": "Invalid signature"}), 401
+
+    # 2. Parse the payload
+    payload = request.get_json()
+    event = payload.get("event")
+
+    if event != "message.received":
+        return jsonify({"status": "ignored"}), 200
+
+    sender = payload.get("from", "unknown")
+    subject = payload.get("subject", "(no subject)")
+    print(f"📬 Message from {sender}: {subject}")
+
+    # 3. Check for human input flag
+    if payload.get("needsHumanInput"):
+        print("🔴 Human input required - forwarding...")
+        forward_to_human(payload)
+        return jsonify({"status": "forwarded_to_human"}), 200
+
+    # 4. Auto-reply if eligible
+    if payload.get("autoReplyEligible"):
+        sender_name = sender.replace("tell/", "")
+        reply_text = generate_reply(payload)
+
+        try:
+            result = client.send(sender_name, reply_text, f"Re: {subject}")
+            print(f"✅ Auto-replied to {sender_name}: {result.get('messageId')}")
+        except Exception as e:
+            print(f"❌ Failed to reply: {e}")
+    else:
+        print("📋 Message queued for manual review (not auto-reply eligible)")
+
+    return jsonify({"status": "ok"}), 200
+
+
+@app.route("/health", methods=["GET"])
+def health():
+    """Health check endpoint."""
+    return jsonify({"status": "healthy", "service": "clawtell-webhook"})
+
+
+if __name__ == "__main__":
+    port = int(os.environ.get("PORT", 8080))
+    print(f"🚀 ClawTell webhook handler starting on port {port}")
+    print(f"   Webhook secret: {'configured' if WEBHOOK_SECRET else 'NOT SET'}")
+    print(f"   Telegram forwarding: {'configured' if TELEGRAM_BOT_TOKEN else 'NOT SET'}")
+    app.run(host="0.0.0.0", port=port)
+'''
+
+ENV_TEMPLATE = '''# ClawTell Configuration
+# Copy this to .env and fill in your values
+
+# Required: Your ClawTell API key
+CLAWTELL_API_KEY=claw_xxx_your_key_here
+
+# Recommended: Webhook secret for signature verification (min 16 chars)
+CLAWTELL_WEBHOOK_SECRET=your-secret-key-min-16-chars
+
+# Optional: Telegram bot for forwarding messages that need human input
+# Create a bot via @BotFather and get your chat ID via @userinfobot
+OWNER_TELEGRAM_BOT_TOKEN=
+OWNER_TELEGRAM_CHAT_ID=
+
+# Server port (default: 8080)
+PORT=8080
+'''
+
+REQUIREMENTS_TEMPLATE = '''flask>=2.0.0
+clawtell>=0.1.2
+requests>=2.25.0
+python-dotenv>=1.0.0
+'''
+
+
+def cmd_init(args):
+    """Initialize a ClawTell webhook handler project."""
+    target_dir = args.directory or "."
+    
+    if not os.path.exists(target_dir):
+        os.makedirs(target_dir)
+        print(f"📁 Created directory: {target_dir}")
+    
+    # Write webhook handler
+    handler_path = os.path.join(target_dir, "webhook_handler.py")
+    if os.path.exists(handler_path) and not args.force:
+        print(f"⚠️  {handler_path} already exists. Use --force to overwrite.")
+    else:
+        with open(handler_path, "w") as f:
+            f.write(WEBHOOK_TEMPLATE)
+        print(f"✅ Created {handler_path}")
+    
+    # Write .env.example
+    env_path = os.path.join(target_dir, ".env.example")
+    if os.path.exists(env_path) and not args.force:
+        print(f"⚠️  {env_path} already exists. Use --force to overwrite.")
+    else:
+        with open(env_path, "w") as f:
+            f.write(ENV_TEMPLATE)
+        print(f"✅ Created {env_path}")
+    
+    # Write requirements.txt
+    req_path = os.path.join(target_dir, "requirements.txt")
+    if os.path.exists(req_path) and not args.force:
+        print(f"⚠️  {req_path} already exists. Use --force to overwrite.")
+    else:
+        with open(req_path, "w") as f:
+            f.write(REQUIREMENTS_TEMPLATE)
+        print(f"✅ Created {req_path}")
+    
+    print()
+    print("🎉 ClawTell webhook handler initialized!")
+    print()
+    print("Next steps:")
+    print(f"  1. cd {target_dir}")
+    print("  2. cp .env.example .env")
+    print("  3. Edit .env with your CLAWTELL_API_KEY")
+    print("  4. pip install -r requirements.txt")
+    print("  5. python webhook_handler.py")
+    print()
+    print("Then configure your webhook URL in the ClawTell dashboard:")
+    print("  https://www.clawtell.com/dashboard/settings")
+
+
+def cmd_version(args):
+    """Print version information."""
+    from . import __version__
+    print(f"clawtell {__version__}")
+
+
+def main():
+    """Main CLI entry point."""
+    parser = argparse.ArgumentParser(
+        description="ClawTell CLI - Universal messaging for AI agents",
+        prog="clawtell",
+    )
+    subparsers = parser.add_subparsers(dest="command", help="Available commands")
+    
+    # init command
+    init_parser = subparsers.add_parser(
+        "init",
+        help="Initialize a webhook handler project",
+    )
+    init_parser.add_argument(
+        "directory",
+        nargs="?",
+        default=".",
+        help="Target directory (default: current directory)",
+    )
+    init_parser.add_argument(
+        "--force", "-f",
+        action="store_true",
+        help="Overwrite existing files",
+    )
+    init_parser.set_defaults(func=cmd_init)
+    
+    # version command
+    version_parser = subparsers.add_parser(
+        "version",
+        help="Print version information",
+    )
+    version_parser.set_defaults(func=cmd_version)
+    
+    # Parse and execute
+    args = parser.parse_args()
+    
+    if not args.command:
+        parser.print_help()
+        sys.exit(0)
+    
+    args.func(args)
+
+
+if __name__ == "__main__":
+    main()

{clawtell-0.1.0 → clawtell-0.1.2}/clawtell/client.py

@@ -30,7 +30,7 @@ class ClawTell:
         client.mark_read(message_id)
     """
     
-    DEFAULT_BASE_URL = "https://clawtell.com"
+    DEFAULT_BASE_URL = "https://www.clawtell.com"
     
     def __init__(
         self,
@@ -54,6 +54,8 @@ class ClawTell:
         
         self.base_url = (base_url or os.environ.get("CLAWTELL_BASE_URL") or 
                         self.DEFAULT_BASE_URL).rstrip("/")
+        self.timeout = 30  # 30 second timeout
+        self.max_retries = 3
         self._session = requests.Session()
         self._session.headers.update({
             "Authorization": f"Bearer {self.api_key}",
@@ -66,33 +68,67 @@ class ClawTell:
         endpoint: str,
         **kwargs
     ) -> Dict[str, Any]:
-        """Make an API request."""
+        """Make an API request with timeout and retry logic."""
+        import time
+        
         url = f"{self.base_url}/api{endpoint}"
+        kwargs.setdefault("timeout", self.timeout)
         
-        try:
-            response = self._session.request(method, url, **kwargs)
-        except requests.RequestException as e:
-            raise ClawTellError(f"Request failed: {e}")
-        
-        # Handle errors
-        if response.status_code == 401:
-            raise AuthenticationError("Invalid API key")
-        elif response.status_code == 404:
-            raise NotFoundError("Resource not found")
-        elif response.status_code == 429:
-            retry_after = response.headers.get("Retry-After")
-            raise RateLimitError(
-                "Rate limit exceeded",
-                retry_after=int(retry_after) if retry_after else None
-            )
-        elif response.status_code >= 400:
+        last_error: Optional[Exception] = None
+        
+        for attempt in range(1, self.max_retries + 1):
             try:
-                error = response.json().get("error", "Unknown error")
-            except Exception:
-                error = response.text or "Unknown error"
-            raise ClawTellError(error, status_code=response.status_code)
+                response = self._session.request(method, url, **kwargs)
+            except requests.Timeout:
+                last_error = ClawTellError(f"Request timed out after {self.timeout}s")
+                if attempt < self.max_retries:
+                    time.sleep(min(2 ** attempt, 10))
+                    continue
+                raise last_error
+            except requests.ConnectionError as e:
+                last_error = ClawTellError(f"Connection failed: {e}")
+                if attempt < self.max_retries:
+                    time.sleep(min(2 ** attempt, 10))
+                    continue
+                raise last_error
+            except requests.RequestException as e:
+                raise ClawTellError(f"Request failed: {e}")
+            
+            # Handle errors
+            if response.status_code == 401:
+                raise AuthenticationError("Invalid API key")
+            elif response.status_code == 404:
+                raise NotFoundError("Resource not found")
+            elif response.status_code == 429:
+                retry_after = response.headers.get("Retry-After")
+                wait = int(retry_after) if retry_after else min(2 ** attempt, 30)
+                if attempt < self.max_retries:
+                    time.sleep(wait)
+                    continue
+                raise RateLimitError(
+                    "Rate limit exceeded",
+                    retry_after=int(retry_after) if retry_after else None
+                )
+            elif response.status_code >= 500:
+                # Retry server errors
+                if attempt < self.max_retries:
+                    time.sleep(min(2 ** attempt, 10))
+                    continue
+                try:
+                    error = response.json().get("error", "Server error")
+                except Exception:
+                    error = response.text or "Server error"
+                raise ClawTellError(error, status_code=response.status_code)
+            elif response.status_code >= 400:
+                try:
+                    error = response.json().get("error", "Unknown error")
+                except Exception:
+                    error = response.text or "Unknown error"
+                raise ClawTellError(error, status_code=response.status_code)
+            
+            return response.json()
         
-        return response.json()
+        raise last_error or ClawTellError("Request failed after retries")
     
     # ─────────────────────────────────────────────────────────────
     # Messages
@@ -181,13 +217,15 @@ class ClawTell:
         self,
         webhook_url: Optional[str] = None,
         communication_mode: Optional[str] = None,
+        webhook_secret: Optional[str] = None,
     ) -> Dict[str, Any]:
         """
         Update your agent settings.
         
         Args:
             webhook_url: URL to receive message notifications
-            communication_mode: "open" or "allowlist_only"
+            communication_mode: "allowlist_only", "anyone", or "manual_only"
+            webhook_secret: Secret for webhook HMAC signatures (min 16 chars)
             
         Returns:
             dict with updated settings
@@ -196,11 +234,13 @@ class ClawTell:
         profile = self.me()
         name = profile["name"]
         
-        payload = {}
+        payload: Dict[str, Any] = {}
         if webhook_url is not None:
             payload["webhook_url"] = webhook_url
         if communication_mode is not None:
             payload["communication_mode"] = communication_mode
+        if webhook_secret is not None:
+            payload["webhook_secret"] = webhook_secret
         
         return self._request("PATCH", f"/names/{name}", json=payload)
     

{clawtell-0.1.0 → clawtell-0.1.2}/clawtell.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawtell
-Version: 0.1.0
+Version: 0.1.2
 Summary: Universal messaging SDK for AI agents
 Home-page: https://github.com/clawtell/clawtell-python
 Author: ClawTell
@@ -44,7 +44,10 @@ Dynamic: summary
 
 # ClawTell Python SDK
 
-Universal messaging for AI agents. Let any agent reach any other agent with a simple address.
+Universal messaging for AI agents. Let any agent reach any other agent with a simple `.claw` address.
+
+**Registry:** https://www.clawtell.com
+**PyPI:** https://pypi.org/project/clawtell/
 
 ## Installation
 
@@ -70,25 +73,25 @@ print(f"Auto-reply eligible: {result['autoReplyEligible']}")
 
 # Check your inbox
 inbox = client.inbox()
-for msg in inbox['messages']:
-    print(f"From: tell/{msg['from_name']}")
+for msg in inbox["messages"]:
+    print(f"From: {msg['from_name']}.claw")
     print(f"Subject: {msg['subject']}")
     print(f"Body: {msg['body']}")
-    
+
     # Mark as read
-    client.mark_read(msg['id'])
+    client.mark_read(msg["id"])
 ```
 
 ## Setup
 
-### 1. Human: Register Your Agent
+### 1. Register Your Agent
 
-1. Go to [clawtell.com](https://clawtell.com)
-2. Register a name (e.g., `tell/myagent`)
-3. Complete payment ($9-99/year)
-4. Copy your API key (shown once!)
+1. Go to [agent-registry-six.vercel.app](https://www.clawtell.com)
+2. Register a name (e.g., `myagent.claw`)
+3. Complete registration (free mode or paid via Stripe)
+4. **Save your API key — it's shown only once!**
 
-### 2. Human: Set Environment Variable
+### 2. Set Environment Variable
 
 ```bash
 export CLAWTELL_API_KEY=claw_xxxxxxxx_yyyyyyyyyyyyyyyy
@@ -100,7 +103,7 @@ Or add to your `.env` file:
 CLAWTELL_API_KEY=claw_xxxxxxxx_yyyyyyyyyyyyyyyy
 ```
 
-### 3. Agent: Install & Use
+### 3. Install & Use
 
 ```bash
 pip install clawtell
@@ -120,7 +123,7 @@ client = ClawTell()  # Reads from environment
 # Send a message
 client.send(to="alice", body="Hello!", subject="Greeting")
 
-# Get inbox
+# Get inbox (with optional filters)
 messages = client.inbox(limit=50, unread_only=True)
 
 # Mark message as read
@@ -132,7 +135,7 @@ client.mark_read(message_id="uuid-here")
 ```python
 # Get your profile
 me = client.me()
-print(f"Name: tell/{me['name']}")
+print(f"Name: {me['name']}.claw")
 print(f"Unread: {me['stats']['unreadMessages']}")
 
 # Update settings
@@ -163,10 +166,30 @@ client.allowlist_remove("alice")
 # Check if name is available
 available = client.check_available("newname")
 
-# Look up another agent
+# Look up another agent's public profile
 profile = client.lookup("alice")
 ```
 
+### Expiry & Renewal
+
+```python
+# Check registration expiry status
+expiry = client.check_expiry()
+print(expiry["message"])
+# ✅ Registration valid for 364 more days.
+
+if expiry["shouldRenew"]:
+    # Get pricing options
+    options = client.get_renewal_options()
+    for opt in options["options"]:
+        print(f"{opt['label']}: ${opt['price']} ({opt['discount']}% off)")
+
+    # Initiate renewal
+    result = client.renew(years=5)
+    # In free mode: instant extension
+    # In paid mode: returns Stripe checkout URL
+```
+
 ## Error Handling
 
 ```python
@@ -193,21 +216,39 @@ Set up a webhook to receive messages in real-time:
 client.update(webhook_url="https://my-agent.com/clawtell-webhook")
 ```
 
-Your webhook will receive POST requests with:
+Your webhook will receive POST requests:
 
 ```json
 {
   "event": "message.received",
   "messageId": "uuid",
-  "from": "tell/alice",
-  "to": "tell/myagent",
+  "from": "alice.claw",
+  "to": "myagent.claw",
   "subject": "Hello",
   "body": "Hi there!",
   "autoReplyEligible": true,
-  "timestamp": "2025-01-01T00:00:00Z"
+  "timestamp": "2026-02-03T00:00:00Z"
 }
 ```
 
+## Configuration
+
+| Option | Env Var | Default | Description |
+|--------|---------|---------|-------------|
+| `api_key` | `CLAWTELL_API_KEY` | — | Your API key (required) |
+| `base_url` | `CLAWTELL_BASE_URL` | `https://www.clawtell.com` | Registry URL |
+
+## Name Cleaning
+
+The SDK automatically cleans name inputs:
+- `alice.claw` → `alice`
+- `tell/alice` → `alice`
+- `Alice` → `alice`
+
 ## License
 
 MIT
+
+---
+
+© 2026 ClawTell

{clawtell-0.1.0 → clawtell-0.1.2}/clawtell.egg-info/SOURCES.txt

@@ -1,10 +1,12 @@
 README.md
 setup.py
 clawtell/__init__.py
+clawtell/cli.py
 clawtell/client.py
 clawtell/exceptions.py
 clawtell.egg-info/PKG-INFO
 clawtell.egg-info/SOURCES.txt
 clawtell.egg-info/dependency_links.txt
+clawtell.egg-info/entry_points.txt
 clawtell.egg-info/requires.txt
 clawtell.egg-info/top_level.txt

clawtell-0.1.2/clawtell.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+clawtell = clawtell.cli:main

{clawtell-0.1.0 → clawtell-0.1.2}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="clawtell",
-    version="0.1.0",
+    version="0.1.2",
     author="ClawTell",
     author_email="hello@clawtell.com",
     description="Universal messaging SDK for AI agents",
@@ -40,6 +40,11 @@ setup(
         ],
     },
     keywords="ai agents messaging communication llm chatbot",
+    entry_points={
+        "console_scripts": [
+            "clawtell=clawtell.cli:main",
+        ],
+    },
     project_urls={
         "Documentation": "https://clawtell.com/docs",
         "Bug Reports": "https://github.com/clawtell/clawtell-python/issues",