@cohortapp/agent-sdk 2.3.0

package/scripts/send-email-as-principal.py

@@ -0,0 +1,369 @@
+#!/usr/bin/env python3
+"""Send a properly threaded HTML email as Alex Chen via Gmail SMTP.
+
+Usage:
+  python3 send-email-as-principal.py <to> <subject> <body> [options]
+
+Options:
+  --reply-to-subject "original subject"   Thread under existing conversation
+  --cc "addr1,addr2"                      CC recipients (comma-separated)
+  --bcc "addr1,addr2"                     BCC recipients (comma-separated)
+  --attachment /path/to/file              Attach a file (can be repeated)
+
+Examples:
+  python3 send-email-as-principal.py "alice@example.com" "Hello" "Body text here"
+  python3 send-email-as-principal.py "bob@co.com" "Re: Project" "Update..." --reply-to-subject "Project"
+  python3 send-email-as-principal.py "carol@co.com" "Report" "Attached." --attachment report.pdf
+  python3 send-email-as-principal.py --help
+"""
+import sys
+import os
+import imaplib
+import email
+import smtplib
+import mimetypes
+import argparse
+from email.mime.multipart import MIMEMultipart
+from email.mime.text import MIMEText
+from email.mime.base import MIMEBase
+from email import encoders
+from email.utils import formatdate
+
+# Outbound dedup — fail-open if module not available
+try:
+    sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+    from outbound_dedup import acquire_email_lock, confirm_email_lock
+    _DEDUP_AVAILABLE = True
+except ImportError:
+    _DEDUP_AVAILABLE = False
+
+# LLM-based dedup — replaces old subject+recipient lock per CEO directive ib-20260406-001
+try:
+    from llm_email_dedup import llm_dedup_check
+    _LLM_DEDUP_AVAILABLE = True
+except ImportError:
+    _LLM_DEDUP_AVAILABLE = False
+
+# Thread quoting — include original email chain in replies — fail-open
+try:
+    from email_quote_thread import fetch_thread_body, format_quoted_html
+    _QUOTE_AVAILABLE = True
+except ImportError:
+    _QUOTE_AVAILABLE = False
+
+# Pre-draft context enrichment (Phase 7) — advisory, never blocks — fail-open
+try:
+    from pre_draft_lookup import pre_draft_lookup
+    _PRE_DRAFT_AVAILABLE = True
+except ImportError:
+    _PRE_DRAFT_AVAILABLE = False
+
+PRINCIPAL_EMAIL = "alex@example.com"
+MEHRAN_NAME = "Alex Chen"
+
+# Load password from environment or .env file
+MEHRAN_PASSWORD = os.environ.get("MEHRAN_GMAIL_APP_PASSWORD", "")
+
+if not MEHRAN_PASSWORD:
+    env_path = os.path.join(os.path.dirname(os.path.dirname(os.path.abspath(__file__))), ".env")
+    if os.path.exists(env_path):
+        with open(env_path) as f:
+            for line in f:
+                line = line.strip()
+                if line.startswith("MEHRAN_GMAIL_APP_PASSWORD="):
+                    MEHRAN_PASSWORD = line.split("=", 1)[1].strip()
+                    break
+
+if not MEHRAN_PASSWORD:
+    print("ERROR: MEHRAN_GMAIL_APP_PASSWORD not set in environment or .env", file=sys.stderr)
+    sys.exit(1)
+
+# Signature HTML — loaded from external file
+SIGNATURE_PATH = os.path.join(os.path.dirname(os.path.abspath(__file__)), "email-signature-principal.html")
+
+
+def load_signature():
+    """Load Alex's HTML signature block from file."""
+    if os.path.exists(SIGNATURE_PATH):
+        with open(SIGNATURE_PATH, "r") as f:
+            return f.read()
+    # Fallback inline signature if file is missing — matches Gmail web app format
+    return """<div dir="ltr">
+<h2 style="color:rgb(0,0,0);vertical-align:baseline;outline:0px;padding:0px;margin:0px 0px 5px;border:0px;line-height:18px;letter-spacing:0.2pt;text-transform:capitalize"><font size="2"><br>Alex Chen<br></font><span style="font-weight:normal"><font face="arial, sans-serif" size="2">Chief Executive Officer</font></span></h2>
+<h2 style="color:rgb(0,0,0);vertical-align:baseline;outline:0px;padding:0px;margin:0px 0px 5px;border:0px;line-height:18px;letter-spacing:0.2pt;text-transform:capitalize"><div style="color:rgb(34,34,34);font-size:small;font-weight:400;letter-spacing:normal;text-transform:none"><font size="2"><br></font></div><div style="color:rgb(34,34,34);font-size:small;font-weight:400;letter-spacing:normal;text-transform:none"><img width="141" height="42" src="https://ci3.googleusercontent.com/mail-sig/AIorK4xNDnPN6a0MjSHV5urb9g11u2CzHIzwdJbwN21quGjzQFdbOdegCq1Wp6lq3NCqsARbi-ooqPfE9E1D" style="margin-right:0px"><br></div></h2>
+<h2 style="color:rgb(34,34,34);vertical-align:baseline;outline:0px;padding:0px;margin:0px 0px 5px;border:0px;line-height:18px"><font face="arial, sans-serif" size="1"><span style="font-weight:normal"><span style="color:rgb(0,0,0);letter-spacing:0.2pt;text-transform:capitalize"><br><a href="tel:+971585291799" style="color:rgb(85,85,85);text-transform:none;font-style:inherit;vertical-align:baseline;outline:0px;padding:0px;margin:0px;border:0px" target="_blank">+971 58 529 1799</a> </span><span style="letter-spacing:0.2pt;text-transform:capitalize"><font color="#999999">(UAE)</font></span><span style="color:rgb(0,0,0);letter-spacing:0.2pt;text-transform:capitalize"> <br></span></span></font></h2>
+<h2 style="vertical-align:baseline;outline:0px;padding:0px;margin:0px 0px 5px;border:0px;line-height:18px"><font color="#555555" face="arial, sans-serif" size="1"><span style="font-weight:400;letter-spacing:0.266667px"><u>+1 646 696 5474</u></span></font><font face="arial, sans-serif" size="1"><span style="color:rgb(0,0,0);font-weight:normal;letter-spacing:0.2pt;text-transform:capitalize"> </span><span style="color:rgb(34,34,34);font-weight:normal;letter-spacing:0.2pt;text-transform:capitalize"><font color="#999999">(USA)</font></span><br><font color="#000000"><span style="font-weight:400;letter-spacing:0.266667px;text-transform:capitalize"><br>Level 1, Innovation One, Dubai International Financial Centre, Dubai, UAE</span></font></font></h2>
+<h2 style="color:rgb(0,0,0);vertical-align:baseline;outline:0px;padding:0px;margin:0px 0px 5px;border:0px;line-height:18px;letter-spacing:0.2pt;text-transform:capitalize"><div style="color:rgb(34,34,34);font-size:small;font-weight:400;letter-spacing:normal;text-transform:none;line-height:20px"></div><div style="color:rgb(34,34,34);font-weight:400;letter-spacing:normal;text-transform:none;font-size:12.8px"><div dir="ltr"><div dir="ltr"><div dir="ltr"><div style="font-size:small"><font face="arial, sans-serif"><span style="color:rgb(153,153,153);font-size:x-small">_________________________________________</span><br></font></div></div><div dir="ltr"><div style="font-size:small"><font size="1" color="#999999" face="arial, sans-serif"><br></font></div><div style="font-size:small"><font size="1" color="#999999"><font face="arial, sans-serif">This email and any files transmitted with it are confidential and intended solely for the use of the individual or entity to whom they are addressed. If you have received this email in error please notify the sender. This message contains confidential information and is intended only for the individual named. If you are not the named addressee you should not disseminate, distribute or copy this email. Please notify the sender immediately by email if you have received this email by mistake and delete this email from your system. If you are not the intended recipient you are notified that disclosing, copying, distributing, or taking any action in reliance on the contents of this information is strictly prohibited.</font></font></div></div></div></div></div></h2>
+</div>"""
+
+
+def get_thread_message_ids(subject_search):
+    """Fetch real Message-IDs from Alex's Gmail via IMAP for threading.
+
+    Searches BOTH Inbox and Sent Mail to find the full thread chain.
+    Gmail threads by In-Reply-To/References headers, so we need all
+    Message-IDs from the conversation regardless of folder.
+    """
+    try:
+        mail = imaplib.IMAP4_SSL("imap.gmail.com")
+        mail.login(PRINCIPAL_EMAIL, MEHRAN_PASSWORD)
+
+        clean_subject = subject_search.replace("Re: ", "").replace("Fwd: ", "").strip()
+        msg_ids = []
+        seen = set()
+
+        for folder in ["INBOX", "[Gmail]/Sent Mail"]:
+            try:
+                mail.select(folder)
+                status, messages = mail.search(None, f'(SUBJECT "{clean_subject}")')
+                if status == "OK" and messages[0]:
+                    for num in messages[0].split():
+                        status, data = mail.fetch(num, '(RFC822.HEADER)')
+                        if status == "OK":
+                            hdr = email.message_from_string(data[0][1].decode('utf-8', errors='replace'))
+                            mid = hdr.get('Message-ID', '')
+                            if mid and mid not in seen:
+                                msg_ids.append(mid)
+                                seen.add(mid)
+            except Exception:
+                continue
+
+        mail.logout()
+        return msg_ids
+    except Exception as e:
+        print(f"Warning: Could not fetch thread IDs: {e}", file=sys.stderr)
+        return []
+
+
+def attach_file(msg, filepath):
+    """Attach a file to the email message."""
+    if not os.path.exists(filepath):
+        print(f"WARNING: Attachment not found: {filepath}", file=sys.stderr)
+        return False
+
+    filename = os.path.basename(filepath)
+    content_type, encoding = mimetypes.guess_type(filepath)
+    if content_type is None:
+        content_type = "application/octet-stream"
+    main_type, sub_type = content_type.split("/", 1)
+
+    with open(filepath, "rb") as f:
+        file_data = f.read()
+
+    attachment = MIMEBase(main_type, sub_type)
+    attachment.set_payload(file_data)
+    encoders.encode_base64(attachment)
+    attachment.add_header("Content-Disposition", "attachment", filename=filename)
+    msg.attach(attachment)
+    return True
+
+
+def check_already_sent(to, subject):
+    """Check Gmail Sent Mail for a recent email to the same recipient with same subject."""
+    try:
+        mail = imaplib.IMAP4_SSL("imap.gmail.com")
+        mail.login(PRINCIPAL_EMAIL, MEHRAN_PASSWORD)
+        mail.select('"[Gmail]/Sent Mail"')
+        clean_subject = subject.replace("RE: ", "").replace("Re: ", "").strip()
+        from datetime import datetime, timedelta
+        since_date = (datetime.now() - timedelta(hours=24)).strftime("%d-%b-%Y")
+        status, messages = mail.search(None, f'(SINCE "{since_date}" TO "{to}" SUBJECT "{clean_subject}")')
+        found = status == "OK" and messages[0] and len(messages[0].split()) > 0
+        count = len(messages[0].split()) if found else 0
+        mail.logout()
+        if found:
+            print(f"SENT_MAIL_DEDUP: Found {count} matching email(s) to {to} in last 24h", file=sys.stderr)
+        return found
+    except Exception as e:
+        print(f"SENT_MAIL_CHECK_ERROR: {e}", file=sys.stderr)
+        return False
+
+
+def send_email(to, subject, body, reply_subject=None, cc=None, bcc=None, attachments=None, in_reply_to=None):
+    """Send an HTML email as Alex Chen via Gmail SMTP."""
+    # ── Pre-draft context enrichment (Phase 7) ─────────────────────
+    # Look up recipient in entity index. Advisory only — never blocks sending.
+    # Logs context to logs/audit/{date}-pre-draft-lookups.jsonl
+    if _PRE_DRAFT_AVAILABLE:
+        try:
+            _ctx = pre_draft_lookup(to, message_type="email")
+            if _ctx and _ctx.get("communication", {}).get("standing_instructions"):
+                print(f"PRE_DRAFT: {len(_ctx['communication']['standing_instructions'])} standing instruction(s) for {to}", file=sys.stderr)
+        except Exception as e:
+            print(f"PRE_DRAFT_WARN (fail-open): {e}", file=sys.stderr)
+
+    # ── Layer 1: LLM-based dedup ──────────────────────────────────────
+    # Reads recent conversation history with the recipient, asks Claude Haiku
+    # whether this topic has already been addressed. Replaces the old
+    # subject+recipient lock per CEO directive ib-20260406-001.
+    if _LLM_DEDUP_AVAILABLE:
+        try:
+            llm_result = llm_dedup_check(to, subject, body,
+                                          sender_email=PRINCIPAL_EMAIL,
+                                          sender_password=MEHRAN_PASSWORD)
+            if llm_result["skip"]:
+                print(f"DEDUP_SKIP (LLM): {llm_result['reason']} [confidence={llm_result['confidence']}, msgs_checked={llm_result['recent_messages']}]")
+                return
+            else:
+                print(f"LLM_DEDUP_OK: {llm_result['reason'][:100]} [msgs_checked={llm_result['recent_messages']}]", file=sys.stderr)
+        except Exception as e:
+            print(f"LLM_DEDUP_WARN (fail-open): {e}", file=sys.stderr)
+
+    # ── Layer 2: Gmail Sent folder check ─────────────────────────────
+    # Pre-send check: query Sent Mail to prevent cross-session duplicates
+    if check_already_sent(to, subject):
+        print(f"DEDUP_SKIP (sent mail check): Already sent to {to} with subject '{subject}' in last 24h")
+        return
+
+    # ── Layer 3: Content-hash dedup ──────────────────────────────────
+    # Outbound dedup: prevent concurrent sessions from sending the same email
+    _dedup_key = None
+    if _DEDUP_AVAILABLE:
+        try:
+            _dedup_key, _dedup_result = acquire_email_lock(to, subject, body)
+            if _dedup_result == "DEDUP_SKIP":
+                print("DEDUP_SKIP (content hash)")
+                return
+        except Exception:
+            pass  # fail-open
+
+    has_attachments = attachments and len(attachments) > 0
+
+    # Use mixed for attachments, alternative for plain HTML
+    if has_attachments:
+        msg = MIMEMultipart("mixed")
+    else:
+        msg = MIMEMultipart("alternative")
+
+    msg['From'] = f'{MEHRAN_NAME} <{PRINCIPAL_EMAIL}>'
+    msg['To'] = to
+    msg['Subject'] = subject
+    msg['Date'] = formatdate(localtime=True)
+
+    if cc:
+        msg['Cc'] = cc
+    if bcc:
+        msg['Bcc'] = bcc
+
+    # Add threading headers if replying
+    # Priority: direct --in-reply-to > subject-based search
+    if in_reply_to:
+        msg['In-Reply-To'] = in_reply_to
+        msg['References'] = in_reply_to
+        if reply_subject:
+            thread_ids = get_thread_message_ids(reply_subject)
+            if thread_ids:
+                all_refs = thread_ids + [in_reply_to]
+                seen = []
+                for r in all_refs:
+                    if r not in seen:
+                        seen.append(r)
+                msg.replace_header('References', ' '.join(seen))
+                print(f"Threading: direct reply-to + {len(thread_ids)} message(s) from subject search")
+        else:
+            print(f"Threading: direct reply-to {in_reply_to}")
+    elif reply_subject:
+        thread_ids = get_thread_message_ids(reply_subject)
+        if thread_ids:
+            msg['In-Reply-To'] = thread_ids[-1]
+            msg['References'] = ' '.join(thread_ids)
+            print(f"Threading: found {len(thread_ids)} message(s) in thread")
+        else:
+            print(f"Threading: no existing messages found for subject '{reply_subject}'")
+
+    # Fetch quoted thread content for replies
+    quoted_html = ""
+    if (reply_subject or in_reply_to) and _QUOTE_AVAILABLE:
+        try:
+            search_subj = reply_subject or subject
+            thread_msg = fetch_thread_body(PRINCIPAL_EMAIL, MEHRAN_PASSWORD, search_subj, exclude_from=PRINCIPAL_EMAIL)
+            quoted_html = format_quoted_html(thread_msg)
+        except Exception as e:
+            print(f"QUOTE_WARN: {e}", file=sys.stderr)
+
+    # Build HTML body with signature
+    signature_html = load_signature()
+    body_html = body.replace('\n', '<br>')
+    html_content = f"""<html><body style="font-family:Arial,Helvetica,sans-serif;font-size:small;color:#000;">
+<div>{body_html}</div>
+<br>
+{signature_html}
+{quoted_html}
+</body></html>"""
+
+    if has_attachments:
+        # Wrap HTML in an alternative part inside the mixed message
+        html_part = MIMEMultipart("alternative")
+        html_part.attach(MIMEText(html_content, 'html'))
+        msg.attach(html_part)
+        # Attach files
+        for filepath in attachments:
+            if attach_file(msg, filepath):
+                print(f"Attached: {os.path.basename(filepath)}")
+    else:
+        msg.attach(MIMEText(html_content, 'html'))
+
+    # Collect all recipients for sending
+    all_recipients = [addr.strip() for addr in to.split(",")]
+    if cc:
+        all_recipients.extend([addr.strip() for addr in cc.split(",")])
+    if bcc:
+        all_recipients.extend([addr.strip() for addr in bcc.split(",")])
+
+    # Send via Gmail SMTP
+    with smtplib.SMTP('smtp.gmail.com', 587) as server:
+        server.starttls()
+        server.login(PRINCIPAL_EMAIL, MEHRAN_PASSWORD)
+        server.send_message(msg)
+
+    print(f"SENT as {MEHRAN_NAME} <{PRINCIPAL_EMAIL}>")
+    print(f"  To: {to}")
+    if cc:
+        print(f"  Cc: {cc}")
+    if bcc:
+        print(f"  Bcc: {bcc}")
+    print(f"  Subject: {subject}")
+    if has_attachments:
+        print(f"  Attachments: {len(attachments)}")
+
+    # Post-send: confirm content-hash lock (audit trail)
+    if _DEDUP_AVAILABLE:
+        try:
+            confirm_email_lock(_dedup_key, f"To:{to} Subj:{subject}", to=to, subject=subject)
+        except Exception:
+            pass
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser(
+        description="Send email as Alex Chen <alex@example.com> via Gmail SMTP",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog="""Examples:
+  %(prog)s "alice@example.com" "Hello" "Body text here"
+  %(prog)s "bob@co.com" "Re: Project" "Update..." --reply-to-subject "Project"
+  %(prog)s "carol@co.com" "Report" "See attached." --attachment report.pdf --cc "team@co.com"
+"""
+    )
+    parser.add_argument("to", help="Recipient email address(es), comma-separated")
+    parser.add_argument("subject", help="Email subject line")
+    parser.add_argument("body", help="Email body text (newlines become <br> in HTML)")
+    parser.add_argument("--reply-to-subject", dest="reply_subject",
+                        help="Original subject for threading (fetches Message-IDs via IMAP)")
+    parser.add_argument("--in-reply-to", dest="in_reply_to",
+                        help="Direct Message-ID to reply to (most reliable threading)")
+    parser.add_argument("--cc", help="CC recipients, comma-separated")
+    parser.add_argument("--bcc", help="BCC recipients, comma-separated")
+    parser.add_argument("--attachment", action="append", dest="attachments",
+                        help="File to attach (can be specified multiple times)")
+    args = parser.parse_args()
+
+    send_email(
+        to=args.to,
+        subject=args.subject,
+        body=args.body,
+        reply_subject=args.reply_subject,
+        cc=args.cc,
+        bcc=args.bcc,
+        attachments=args.attachments,
+        in_reply_to=args.in_reply_to,
+    )