feat: add Sales Call News Researcher agent

[Samir-atra]

Description

This PR adds a new agent template: Sales Call News Researcher — an intelligent assistant that automatically prepares personalized company news briefings before sales calls.

The agent scans your Google Calendar for upcoming meetings, identifies the companies you're meeting with, fetches recent news about each company, curates the most relevant articles, and sends you briefing emails to help you walk into every meeting informed about your prospect's latest developments.

Type of Change

• New feature (non-breaking change that adds functionality)

Related Issues

Resolves #4651

Changes Made

• Created examples/templates/sales_call_news_researcher/ directory with complete agent implementation
• 6 nodes implementing the full workflow:
  • calendar-scan: Scans Google Calendar for upcoming sales calls
  • company-identifier: Extracts and normalizes company names from meeting data
  • news-fetcher: Searches for recent news using news_search and web_search tools
  • news-curator: Filters and prioritizes the most relevant articles for sales context
  • email-composer: Creates personalized briefing emails with talking points
  • email-sender: Presents drafts for user approval and sends via Gmail
• 6 edges defining the workflow: calendar-scan → company-identifier → news-fetcher → news-curator → email-composer → email-sender → (loop back)
• Goal definition with 5 success criteria and 4 constraints
• Unit tests covering goal, nodes, edges, graph configuration, and agent class
• CLI interface with run, tui, info, and validate commands

Testing

• Unit tests pass (cd core && pytest ../examples/templates/sales_call_news_researcher/tests/)
  • 18 tests passed, 1 skipped (credential-dependent test)
• Lint passes (cd core && ruff check ../examples/templates/sales_call_news_researcher/)
• Agent validation passes

Checklist

• My code follows the project's style guidelines
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• My changes generate no new warnings
• I have added tests that prove my feature works
• New and existing unit tests pass locally with my changes

Usage

# Run the agent
cd core && uv run python -m sales_call_news_researcher run

# Launch TUI dashboard
cd core && uv run python -m sales_call_news_researcher tui

# Show agent info
cd core && uv run python -m sales_call_news_researcher info

# Validate agent structure
cd core && uv run python -m sales_call_news_researcher validate

Credentials Required

• GOOGLE_ACCESS_TOKEN - For Google Calendar and Gmail
• NEWSDATA_API_KEY or FINLIGHT_API_KEY - For news search (optional, falls back to web search)
• BRAVE_SEARCH_API_KEY or GOOGLE_API_KEY + GOOGLE_CSE_ID - For web search

[github-actions]

PR Requirements Warning

This PR does not meet the contribution requirements.
If the issue is not fixed within ~24 hours, it may be automatically closed.

PR Author: @Samir-atra
Found issues: #4651 (assignees: none)
Problem: The PR author must be assigned to the linked issue.

To fix:

1. Assign yourself (@Samir-atra) to one of the linked issues
2. Re-open this PR

Exception: To bypass this requirement, you can:

• Add the micro-fix label or include micro-fix in your PR title for trivial fixes
• Add the documentation label or include doc/docs in your PR title for documentation changes

Micro-fix requirements (must meet ALL):

Qualifies	Disqualifies
< 20 lines changed	Any functional bug fix
Typos & Documentation & Linting	Refactoring for "clean code"
No logic/API/DB changes	New features (even tiny ones)

Why is this required? See #472 for details.