Skip to main content

Daily Digest

The Daily Digest feature provides a consolidated view of your emails, organized by category with AI-generated summaries.

Overview​

Digest Structure​

Categories Section​

Emails grouped by type:

📋 Need-Action (3)
├── Meeting invite from John
├── Urgent: Project deadline
└── Please review PR #42

📖 FYI (5)
├── Monthly report published
├── System maintenance notice
└── ...

📰 Newsletter (4)
├── TechCrunch Daily
├── Morning Brew
└── ...

Newsletter Summaries​

Each newsletter gets an AI-generated summary:

📰 TechCrunch Daily
Summary: Today's top stories include Apple's new AI features,
startup funding rounds, and regulatory updates in the EU.
Key topics: AI, Startups, Regulation

📰 Morning Brew
Summary: Market updates show tech stocks rising, with focus
on Q4 earnings reports and holiday shopping trends.
Key topics: Markets, Retail, Tech

Generation Process​

1. Fetch Emails​

def fetch_emails(max_count: int = 10) -> list[dict]:
    """Fetch recent unread emails from Gmail."""
    query = "is:unread newer_than:1d"

    results = gmail_service.users().messages().list(
        userId='me',
        q=query,
        maxResults=max_count,
    ).execute()

    messages = results.get('messages', [])
    return [get_message_details(msg['id']) for msg in messages]

2. Categorize Each Email​

def process_emails(emails: list[dict]) -> dict[str, list]:
    """Categorize emails and group by category."""
    categorized = {
        'Need-Action': [],
        'FYI': [],
        'Newsletter': [],
        'Promotional': [],
        'Social': [],
    }

    for email in emails:
        category = categorize_email(email)
        categorized[category].append(email)

    return categorized

3. Generate Summaries​

def generate_category_summary(category: str, emails: list[dict]) -> str:
    """Generate AI summary for a category."""
    if not emails:
        return "No emails in this category."

    email_list = "\n".join([
        f"- {email['subject']} (from {email['from']})"
        for email in emails[:5]  # Limit for prompt size
    ])

    prompt = f"""
    Summarize these {category} emails in 2-3 sentences:

    {email_list}

    Focus on key action items or themes.
    """

    response = gemini_client.generate_content(prompt)
    return response.text

4. Newsletter Highlights​

def extract_newsletter_highlights(email: dict) -> dict:
    """Extract key points from newsletter."""
    prompt = f"""
    Extract key highlights from this newsletter:

    Subject: {email['subject']}
    Content: {email['body'][:1000]}

    Return:
    - 2-3 sentence summary
    - Top 3 topics covered
    """

    response = gemini_client.generate_content(prompt)
    return parse_highlights(response.text)

Web Interface​

Digest View​

┌─────────────────────────────────────────────────┐
│  📧 Email Digest                    [Refresh]   │
│  Generated: Dec 22, 2024 at 9:30 AM             │
├─────────────────────────────────────────────────┤
│                                                 │
│  📋 Need-Action (3)                             │
│  ┌─────────────────────────────────────────┐   │
│  │ 📌 Meeting: Q4 Review                   │   │
│  │    From: manager@company.com            │   │
│  │    Action: Accept/Decline by EOD        │   │
│  └─────────────────────────────────────────┘   │
│                                                 │
│  📖 FYI (5)                                     │
│  ┌─────────────────────────────────────────┐   │
│  │ Summary: 5 informational emails about   │   │
│  │ project updates and system notices.     │   │
│  └─────────────────────────────────────────┘   │
│                                                 │
│  📰 Newsletter (4)                              │
│  ┌─────────────────────────────────────────┐   │
│  │ 🗞️ TechCrunch Daily                     │   │
│  │ AI advances, startup news, EU tech laws │   │
│  │                                          │   │
│  │ 🗞️ Morning Brew                         │   │
│  │ Market rally continues, retail outlook  │   │
│  └─────────────────────────────────────────┘   │
│                                                 │
└─────────────────────────────────────────────────┘

Refresh Functionality​

// script.js
async function refreshDigest() {
    const button = document.getElementById('refresh-btn');
    button.disabled = true;
    button.textContent = 'Refreshing...';

    try {
        const response = await fetch('/api/refresh', { method: 'POST' });
        if (response.ok) {
            location.reload();
        }
    } finally {
        button.disabled = false;
        button.textContent = 'Refresh';
    }
}

Data Persistence​

Digest Storage​

def save_digest(digest_data: dict) -> None:
    """Save digest to JSON file."""
    path = Path('data/digest/latest.json')

    with open(path, 'w') as f:
        json.dump({
            'generated_at': datetime.now().isoformat(),
            'data': digest_data,
        }, f, indent=2)

Cache Integration​

Performance​

MetricValue
First run (10 emails)13-20 seconds
Cached run5-8 seconds
Page load< 1 second

Optimization Tips​

  1. Reduce email count: Fetch only what you need
  2. Enable caching: Avoid redundant API calls
  3. Batch processing: Process emails in parallel
  4. Limit summaries: Only summarize newsletters

Configuration​

{
  "gmail_settings": {
    "max_emails_to_fetch": 10,
    "search_query": "is:unread newer_than:1d"
  },
  "digest_settings": {
    "include_promotional": false,
    "include_social": false,
    "newsletter_summary_length": 100
  }
}