clawtell 0.1.2__py3-none-any.whl → 0.1.3__py3-none-any.whl

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.2"
+__version__ = "0.1.3"
 __all__ = ["ClawTell", "ClawTellError", "AuthenticationError", "NotFoundError", "RateLimitError"]

clawtell/cli.py

@@ -13,20 +13,40 @@ Run with: python webhook_handler.py
 import os
 import hmac
 import hashlib
+import requests
 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)
+# ══════════════════════════════════════════════════════════════════════
+# CONFIGURATION - Set these environment variables
+# ══════════════════════════════════════════════════════════════════════
 
+# Required: Your ClawTell API key
+# CLAWTELL_API_KEY=claw_xxx_your_key_here
+
+# Recommended: Webhook secret for signature verification (min 16 chars)
 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", "")
+
+# ── Human Notification Channels ───────────────────────────────────────
+# Configure ONE OR MORE of these to receive alerts when needsHumanInput=true
+# Leave unconfigured channels empty - only configured ones will be used
+
+# Telegram: Create bot via @BotFather, get chat ID via @userinfobot
+TELEGRAM_BOT_TOKEN = os.environ.get("TELEGRAM_BOT_TOKEN", "")
+TELEGRAM_CHAT_ID = os.environ.get("TELEGRAM_CHAT_ID", "")
+
+# Discord: Create webhook in channel settings → Integrations → Webhooks
+DISCORD_WEBHOOK_URL = os.environ.get("DISCORD_WEBHOOK_URL", "")
+
+# Slack: Create incoming webhook at api.slack.com/apps → Incoming Webhooks
+SLACK_WEBHOOK_URL = os.environ.get("SLACK_WEBHOOK_URL", "")
+
+# Generic webhook: Any URL that accepts POST with JSON body
+NOTIFY_WEBHOOK_URL = os.environ.get("NOTIFY_WEBHOOK_URL", "")
+
+# ══════════════════════════════════════════════════════════════════════
 
 # Initialize ClawTell client (reads CLAWTELL_API_KEY from env)
 client = ClawTell()
@@ -44,34 +64,115 @@ def verify_signature(payload_bytes: bytes, signature: str) -> bool:
     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
+def notify_human(payload: dict) -> bool:
+    """
+    Forward message to human via all configured channels.
+    Returns True if at least one channel succeeded.
+    """
+    sender = payload.get("from", "unknown")
+    subject = payload.get("subject", "(no subject)")
+    body = payload.get("body", "")[:1000]  # Truncate long messages
+    message_id = payload.get("messageId", "")[:8]
     
-    import requests
+    success = False
     
-    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', '')}"
-    )
+    # ── Telegram ──────────────────────────────────────────────────────
+    if TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID:
+        try:
+            text = (
+                f"🔴 *Human Input Needed*\\n\\n"
+                f"From: `{sender}`\\n"
+                f"Subject: {subject}\\n"
+                f"ID: `{message_id}`\\n\\n"
+                f"{body}"
+            )
+            resp = 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,
+            )
+            if resp.ok:
+                print(f"✅ Notified via Telegram")
+                success = True
+            else:
+                print(f"⚠️ Telegram failed: {resp.status_code}")
+        except Exception as e:
+            print(f"❌ Telegram error: {e}")
     
-    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}")
+    # ── Discord ───────────────────────────────────────────────────────
+    if DISCORD_WEBHOOK_URL:
+        try:
+            content = (
+                f"🔴 **Human Input Needed**\\n\\n"
+                f"**From:** `{sender}`\\n"
+                f"**Subject:** {subject}\\n"
+                f"**ID:** `{message_id}`\\n\\n"
+                f"{body}"
+            )
+            resp = requests.post(
+                DISCORD_WEBHOOK_URL,
+                json={"content": content},
+                timeout=10,
+            )
+            if resp.ok:
+                print(f"✅ Notified via Discord")
+                success = True
+            else:
+                print(f"⚠️ Discord failed: {resp.status_code}")
+        except Exception as e:
+            print(f"❌ Discord error: {e}")
+    
+    # ── Slack ─────────────────────────────────────────────────────────
+    if SLACK_WEBHOOK_URL:
+        try:
+            text = (
+                f"🔴 *Human Input Needed*\\n\\n"
+                f"*From:* `{sender}`\\n"
+                f"*Subject:* {subject}\\n"
+                f"*ID:* `{message_id}`\\n\\n"
+                f"{body}"
+            )
+            resp = requests.post(
+                SLACK_WEBHOOK_URL,
+                json={"text": text},
+                timeout=10,
+            )
+            if resp.ok:
+                print(f"✅ Notified via Slack")
+                success = True
+            else:
+                print(f"⚠️ Slack failed: {resp.status_code}")
+        except Exception as e:
+            print(f"❌ Slack error: {e}")
+    
+    # ── Generic Webhook ───────────────────────────────────────────────
+    if NOTIFY_WEBHOOK_URL:
+        try:
+            resp = requests.post(
+                NOTIFY_WEBHOOK_URL,
+                json={
+                    "event": "human_input_needed",
+                    "from": sender,
+                    "subject": subject,
+                    "body": body,
+                    "message_id": message_id,
+                    "original_payload": payload,
+                },
+                timeout=10,
+            )
+            if resp.ok:
+                print(f"✅ Notified via custom webhook")
+                success = True
+            else:
+                print(f"⚠️ Custom webhook failed: {resp.status_code}")
+        except Exception as e:
+            print(f"❌ Custom webhook error: {e}")
+    
+    if not success and not any([TELEGRAM_BOT_TOKEN, DISCORD_WEBHOOK_URL, SLACK_WEBHOOK_URL, NOTIFY_WEBHOOK_URL]):
+        print("⚠️ No notification channels configured - can't forward to human")
+        print("   Set TELEGRAM_*, DISCORD_WEBHOOK_URL, SLACK_WEBHOOK_URL, or NOTIFY_WEBHOOK_URL")
+    
+    return success
 
 
 def generate_reply(payload: dict) -> str:
@@ -105,8 +206,8 @@ def handle_webhook():
 
     # 3. Check for human input flag
     if payload.get("needsHumanInput"):
-        print("🔴 Human input required - forwarding...")
-        forward_to_human(payload)
+        print("🔴 Human input required - forwarding to owner...")
+        notify_human(payload)
         return jsonify({"status": "forwarded_to_human"}), 200
 
     # 4. Auto-reply if eligible
@@ -133,25 +234,52 @@ def health():
 
 if __name__ == "__main__":
     port = int(os.environ.get("PORT", 8080))
+    
+    # Show configured channels
+    channels = []
+    if TELEGRAM_BOT_TOKEN and TELEGRAM_CHAT_ID:
+        channels.append("Telegram")
+    if DISCORD_WEBHOOK_URL:
+        channels.append("Discord")
+    if SLACK_WEBHOOK_URL:
+        channels.append("Slack")
+    if NOTIFY_WEBHOOK_URL:
+        channels.append("Custom webhook")
+    
     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'}")
+    print(f"   Webhook secret: {'configured ✓' if WEBHOOK_SECRET else 'NOT SET'}")
+    print(f"   Human notifications: {', '.join(channels) if channels else 'NONE CONFIGURED'}")
     app.run(host="0.0.0.0", port=port)
 '''
 
-ENV_TEMPLATE = '''# ClawTell Configuration
+ENV_TEMPLATE = '''# ══════════════════════════════════════════════════════════════════════
+# ClawTell Configuration
 # Copy this to .env and fill in your values
+# ══════════════════════════════════════════════════════════════════════
 
-# Required: Your ClawTell API key
+# Required: Your ClawTell API key (get from dashboard after registration)
 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=
+# ── Human Notification Channels ───────────────────────────────────────
+# Configure ONE OR MORE channels to receive alerts when needsHumanInput=true
+# Only fill in the channels you want to use - leave others empty
+
+# Telegram: Create bot via @BotFather, get chat ID via @userinfobot
+TELEGRAM_BOT_TOKEN=
+TELEGRAM_CHAT_ID=
+
+# Discord: Channel Settings → Integrations → Webhooks → New Webhook
+DISCORD_WEBHOOK_URL=
+
+# Slack: api.slack.com/apps → Your App → Incoming Webhooks → Add
+SLACK_WEBHOOK_URL=
+
+# Generic webhook: Any URL that accepts POST with JSON body
+# Payload: { event, from, subject, body, message_id, original_payload }
+NOTIFY_WEBHOOK_URL=
 
 # Server port (default: 8080)
 PORT=8080
@@ -206,8 +334,9 @@ def cmd_init(args):
     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("  4. Configure at least one notification channel (Telegram/Discord/Slack)")
+    print("  5. pip install -r requirements.txt")
+    print("  6. python webhook_handler.py")
     print()
     print("Then configure your webhook URL in the ClawTell dashboard:")
     print("  https://www.clawtell.com/dashboard/settings")

{clawtell-0.1.2.dist-info → clawtell-0.1.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawtell
-Version: 0.1.2
+Version: 0.1.3
 Summary: Universal messaging SDK for AI agents
 Home-page: https://github.com/clawtell/clawtell-python
 Author: ClawTell

clawtell-0.1.3.dist-info/RECORD

@@ -0,0 +1,9 @@
+clawtell/__init__.py,sha256=BhjKMjTEmS3ACzWcyVBhP_sIGa-3fyKKw55zg9vQfzQ,304
+clawtell/cli.py,sha256=BruTSnAa5Z4kDcvgaAgQhCwjEuiYi9uI_T4uyEGf90o,14516
+clawtell/client.py,sha256=dkAx9Df9YD6LYo3oD_J09KMnLwBsJX_46DxSYMFu2Ww,14143
+clawtell/exceptions.py,sha256=HQxHk68Z1BkV3RKsIqt5pTmCcH5Abe6dnWIs-OFqe9s,722
+clawtell-0.1.3.dist-info/METADATA,sha256=HJjKd2y8jcUhIpmbGRy1hZgn52lmoTh7agw4IGVd5JY,5858
+clawtell-0.1.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+clawtell-0.1.3.dist-info/entry_points.txt,sha256=QSphdy-oEADOkCz63ROVmNZ2FXCYfkJvuSM6ym4Nhho,47
+clawtell-0.1.3.dist-info/top_level.txt,sha256=V6KZMDnZ41xr_BEe0DpG-qlvRjwOtL1cDHAFamomSpM,9
+clawtell-0.1.3.dist-info/RECORD,,

clawtell-0.1.2.dist-info/RECORD

@@ -1,9 +0,0 @@
-clawtell/__init__.py,sha256=-uneQZO-iDvfR2KRHW9SLPB-FWfzFvoGX9uj9hVcoho,304
-clawtell/cli.py,sha256=ZHxd_zEFLqdhTsULGJf0vMmdA4V0JA7ioemr0eBrlMc,8240
-clawtell/client.py,sha256=dkAx9Df9YD6LYo3oD_J09KMnLwBsJX_46DxSYMFu2Ww,14143
-clawtell/exceptions.py,sha256=HQxHk68Z1BkV3RKsIqt5pTmCcH5Abe6dnWIs-OFqe9s,722
-clawtell-0.1.2.dist-info/METADATA,sha256=G9b36zRTlJLa79pi9HPUB4U1hucUYfcfsHYheuTNoDk,5858
-clawtell-0.1.2.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-clawtell-0.1.2.dist-info/entry_points.txt,sha256=QSphdy-oEADOkCz63ROVmNZ2FXCYfkJvuSM6ym4Nhho,47
-clawtell-0.1.2.dist-info/top_level.txt,sha256=V6KZMDnZ41xr_BEe0DpG-qlvRjwOtL1cDHAFamomSpM,9
-clawtell-0.1.2.dist-info/RECORD,,