webex-email-reminders 0.1.0__tar.gz

webex_email_reminders-0.1.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: webex-email-reminders
+Version: 0.1.0
+Summary: CLI tool that monitors Webex mentions and DMs, sends email summaries via Nylas
+Requires-Python: >=3.9
+Requires-Dist: nylas==6.2.0
+Requires-Dist: requests==2.32.3

webex_email_reminders-0.1.0/README.md

@@ -0,0 +1,56 @@
+# Webex Email Reminders
+
+CLI tool that checks Webex for mentions and direct messages from the last hour and sends an email summary via Nylas.
+
+## Prerequisites
+
+- Python 3.9+
+- Nylas CLI: `brew install nylas/nylas-cli/nylas`
+
+## Setup
+
+```bash
+pip install -r requirements.txt
+```
+
+## Environment Variables
+
+```bash
+export WEBEX_JWT="your-webex-personal-access-token"
+export NYLAS_API_KEY="your-nylas-api-key"
+export NYLAS_GRANT_ID="your-nylas-grant-id"
+```
+
+## Usage
+
+```bash
+# Send summary email
+python webex_reminders.py --to your@email.com
+
+# Custom time window
+python webex_reminders.py --to your@email.com --hours 2
+
+# Filter DMs by contacts file
+python webex_reminders.py --to your@email.com --contacts contacts.txt
+
+# Dry run (prints email content without sending)
+python webex_reminders.py --to your@email.com --dry-run
+```
+
+### Options
+
+| Flag | Description |
+|------|-------------|
+| `--to` | Email address to send summary to (required) |
+| `--hours` | Look back period in hours (default: 1) |
+| `--contacts` | Text file with email addresses to filter DMs |
+| `--dry-run` | Print email content to stdout without sending |
+
+## Contacts File (optional)
+
+One email per line to filter which DMs to include:
+
+```
+person1@company.com
+person2@company.com
+```

webex_email_reminders-0.1.0/pyproject.toml

@@ -0,0 +1,16 @@
+[build-system]
+requires = ["setuptools>=68.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "webex-email-reminders"
+version = "0.1.0"
+description = "CLI tool that monitors Webex mentions and DMs, sends email summaries via Nylas"
+requires-python = ">=3.9"
+dependencies = [
+    "nylas==6.2.0",
+    "requests==2.32.3",
+]
+
+[project.scripts]
+webex-reminders = "webex_reminders:main"

webex_email_reminders-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

webex_email_reminders-0.1.0/webex_email_reminders.egg-info/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: webex-email-reminders
+Version: 0.1.0
+Summary: CLI tool that monitors Webex mentions and DMs, sends email summaries via Nylas
+Requires-Python: >=3.9
+Requires-Dist: nylas==6.2.0
+Requires-Dist: requests==2.32.3

webex_email_reminders-0.1.0/webex_email_reminders.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+webex_reminders.py
+webex_email_reminders.egg-info/PKG-INFO
+webex_email_reminders.egg-info/SOURCES.txt
+webex_email_reminders.egg-info/dependency_links.txt
+webex_email_reminders.egg-info/entry_points.txt
+webex_email_reminders.egg-info/requires.txt
+webex_email_reminders.egg-info/top_level.txt

webex_email_reminders-0.1.0/webex_email_reminders.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

webex_email_reminders-0.1.0/webex_email_reminders.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+webex-reminders = webex_reminders:main

webex_email_reminders-0.1.0/webex_email_reminders.egg-info/requires.txt

@@ -0,0 +1,2 @@
+nylas==6.2.0
+requests==2.32.3

webex_email_reminders-0.1.0/webex_email_reminders.egg-info/top_level.txt

@@ -0,0 +1 @@
+webex_reminders

webex_email_reminders-0.1.0/webex_reminders.py

@@ -0,0 +1,192 @@
+#!/usr/bin/env python3
+"""Webex Email Reminders - Check Webex mentions and DMs, send email summary via Nylas."""
+
+import argparse
+import os
+import sys
+from datetime import datetime, timedelta, timezone
+
+import requests
+from nylas import Client as NylasClient
+
+
+def get_webex_headers():
+    token = os.environ.get("WEBEX_JWT")
+    if not token:
+        sys.exit("Error: WEBEX_JWT environment variable not set")
+    return {"Authorization": f"Bearer {token}"}
+
+
+def get_me(headers):
+    resp = requests.get("https://webexapis.com/v1/people/me", headers=headers)
+    resp.raise_for_status()
+    return resp.json()
+
+
+def get_mentions(headers, since):
+    """Get messages where you are mentioned across all spaces."""
+    rooms_resp = requests.get(
+        "https://webexapis.com/v1/rooms", headers=headers, params={"max": 50, "sortBy": "lastactivity"}
+    )
+    rooms_resp.raise_for_status()
+
+    messages = []
+    for room in rooms_resp.json().get("items", []):
+        last_activity = datetime.fromisoformat(room["lastActivity"].replace("Z", "+00:00"))
+        if last_activity < since:
+            break
+        if room.get("type") == "direct":
+            continue
+
+        msgs_resp = requests.get(
+            "https://webexapis.com/v1/messages",
+            headers=headers,
+            params={"roomId": room["id"], "mentionedPeople": "me", "max": 20},
+        )
+        if msgs_resp.status_code != 200:
+            continue
+
+        for msg in msgs_resp.json().get("items", []):
+            created = datetime.fromisoformat(msg["created"].replace("Z", "+00:00"))
+            if created >= since:
+                msg["_spaceName"] = room.get("title", "Unknown Space")
+                messages.append(msg)
+    return messages
+
+
+def get_direct_messages(headers, since, contacts_file=None):
+    """Get direct messages from the last hour, optionally filtered by a contacts file."""
+    allowed_emails = None
+    if contacts_file and os.path.exists(contacts_file):
+        with open(contacts_file) as f:
+            allowed_emails = {line.strip().lower() for line in f if line.strip()}
+
+    rooms_resp = requests.get(
+        "https://webexapis.com/v1/rooms", headers=headers, params={"type": "direct", "max": 50}
+    )
+    rooms_resp.raise_for_status()
+
+    messages = []
+    for room in rooms_resp.json().get("items", []):
+        last_activity = datetime.fromisoformat(room["lastActivity"].replace("Z", "+00:00"))
+        if last_activity < since:
+            continue
+
+        msgs_resp = requests.get(
+            "https://webexapis.com/v1/messages",
+            headers=headers,
+            params={"roomId": room["id"], "max": 20},
+        )
+        msgs_resp.raise_for_status()
+
+        for msg in msgs_resp.json().get("items", []):
+            created = datetime.fromisoformat(msg["created"].replace("Z", "+00:00"))
+            if created < since:
+                break
+            sender = msg.get("personEmail", "").lower()
+            if allowed_emails and sender not in allowed_emails:
+                continue
+            messages.append(msg)
+
+    return messages
+
+
+def format_email_body(mentions, dms):
+    """Format mentions and DMs into an HTML email body."""
+    body = "<h2>Webex Summary - Last Hour</h2>"
+
+    if mentions:
+        body += "<h3>Mentions</h3>"
+        grouped = {}
+        for msg in mentions:
+            space = msg.get("_spaceName", "Unknown Space")
+            grouped.setdefault(space, []).append(msg)
+        for space, msgs in grouped.items():
+            body += f"<h4>{space}</h4><ul>"
+            for msg in msgs:
+                sender = msg.get("personEmail", "unknown")
+                text = msg.get("text", "")[:200]
+                time = msg["created"][:16].replace("T", " ")
+                body += f"<li><b>{sender}</b> ({time}): {text}</li>"
+            body += "</ul>"
+
+    if dms:
+        body += "<h3>Direct Messages</h3><ul>"
+        for msg in dms:
+            sender = msg.get("personEmail", "unknown")
+            text = msg.get("text", "")[:200]
+            time = msg["created"][:16].replace("T", " ")
+            body += f"<li><b>{sender}</b> ({time}): {text}</li>"
+        body += "</ul>"
+
+    if not mentions and not dms:
+        body += "<p>No new mentions or direct messages in the last hour.</p>"
+
+    return body
+
+
+def send_email(to_email, subject, body):
+    """Send email via Nylas SDK."""
+    api_key = os.environ.get("NYLAS_API_KEY")
+    grant_id = os.environ.get("NYLAS_GRANT_ID")
+    if not api_key or not grant_id:
+        sys.exit("Error: NYLAS_API_KEY and NYLAS_GRANT_ID environment variables required")
+
+    nylas = NylasClient(api_key=api_key)
+    nylas.messages.send(
+        grant_id,
+        request_body={
+            "to": [{"email": to_email}],
+            "subject": subject,
+            "body": body,
+        },
+    )
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Webex Email Reminders")
+    parser.add_argument("--hours", type=float, default=1, help="Look back period in hours (default: 1)")
+    parser.add_argument("--to", help="Email address to send summary to")
+    parser.add_argument("--to-list", help="Text file with email addresses to send to (one per line)")
+    parser.add_argument("--contacts", help="Text file with email addresses to filter DMs (one per line)")
+    parser.add_argument("--dry-run", action="store_true", help="Print summary without sending email")
+    args = parser.parse_args()
+
+    if not args.to and not args.to_list:
+        parser.error("either --to or --to-list is required")
+
+    since = datetime.now(timezone.utc) - timedelta(hours=args.hours)
+    headers = get_webex_headers()
+
+    print(f"Checking Webex for activity since {since.isoformat()}...")
+
+    mentions = get_mentions(headers, since)
+    print(f"  Found {len(mentions)} mention(s)")
+
+    dms = get_direct_messages(headers, since, args.contacts)
+    print(f"  Found {len(dms)} direct message(s)")
+
+    if not mentions and not dms:
+        print("Nothing to report.")
+        return
+
+    body = format_email_body(mentions, dms)
+    subject = f"Webex Summary - {len(mentions)} mention(s), {len(dms)} DM(s)"
+
+    recipients = []
+    if args.to:
+        recipients.append(args.to)
+    if args.to_list and os.path.exists(args.to_list):
+        with open(args.to_list) as f:
+            recipients.extend(line.strip() for line in f if line.strip())
+
+    if args.dry_run:
+        print(f"\n--- DRY RUN ---\nTo: {', '.join(recipients)}\nSubject: {subject}\n\n{body}")
+    else:
+        for recipient in recipients:
+            send_email(recipient, subject, body)
+        print(f"Email sent to {', '.join(recipients)}")
+
+
+if __name__ == "__main__":
+    main()