Daily Digest

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

Overview

┌─────────────────────────────────────────────────────────────────┐
│                    DIGEST GENERATION FLOW                        │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│   ┌─────────────┐    ┌─────────────┐    ┌─────────────────┐    │
│   │   Fetch     │───▶│ Categorize  │───▶│  Group by       │    │
│   │   Emails    │    │   Each      │    │  Category       │    │
│   └─────────────┘    └─────────────┘    └────────┬────────┘    │
│                                                   │              │
│                                                   ▼              │
│                      ┌─────────────┐    ┌─────────────────┐    │
│                      │   Render    │◀───│   Generate      │    │
│                      │   Digest    │    │   Summaries     │    │
│                      └─────────────┘    └─────────────────┘    │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

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

┌─────────────────────────────────────────────────────────────────┐
│                      CACHE INTEGRATION                           │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│   ┌─────────────┐          ┌─────────────────┐                  │
│   │ New Request │─────────▶│  Digest Fresh?  │                  │
│   └─────────────┘          └────────┬────────┘                  │
│                                     │                            │
│                            Yes      │      No                    │
│                            ┌────────┴────────┐                  │
│                            │                 │                   │
│                            ▼                 ▼                   │
│                     ┌───────────┐     ┌───────────┐             │
│                     │  Return   │     │ Regenerate│             │
│                     │  Cached   │     │           │             │
│                     └───────────┘     └─────┬─────┘             │
│                            ▲                │                    │
│                            │                ▼                    │
│                            │         ┌───────────┐              │
│                            └─────────│   Save    │              │
│                                      │ to Cache  │              │
│                                      └───────────┘              │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

Performance

Metric	Value
First run (10 emails)	13-20 seconds
Cached run	5-8 seconds
Page load	< 1 second

Optimization Tips

Reduce Email Count

Fetch only what you need to process

Enable Caching

Avoid redundant API calls

Batch Processing

Process emails in parallel

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
  }
}