feat(examples): News Summarizer Agent with local Ollama + DuckDuckGo

[ssjgit08]

Summary

• Problem: No example showing Bindu as an active news research agent
• Why it matters: Demonstrates Bindu's real-world value beyond passive text processing
• What changed: Added examples/news-summarizer/ with full agent, skill, README
• What did NOT change: Core Bindu framework completely untouched

Change Type

• Feature
• Documentation

Scope

• Documentation

Linked Issue/PR

• Closes #
• Related #

User-Visible / Behavior Changes

New example agent available at examples/news-summarizer/

Security Impact

• New permissions/capabilities? No
• Secrets/credentials handling changed? No
• New/changed network calls? Yes — DuckDuckGo web search
• Database schema/migration changes? No
• Authentication/authorization changes? No
• DuckDuckGo search makes outbound HTTP calls. No credentials involved, public search only.

Verification

Environment

• OS: macOS (MacBook Air M2)
• Python version: 3.12.9
• Storage backend: memory
• Scheduler backend: memory

Steps to Test

1. Install Ollama and run ollama pull llama3.2
2. Run python examples/news-summarizer/news_agent.py
3. Send request via curl as documented in README.md

Expected Behavior

• Agent starts on localhost:3773
• Returns top 3 headlines + summaries + sentiment for any topic

Actual Behavior

• Works as expected

Evidence

• Test output / logs
• Screenshot / recording

Agent response tested with "Give me latest cricket news":

Top 3 Headlines:
1. Australia's T20 World Cup Failure Could Affect Olympic Cricket Bid
2. Former Cricket Captains Urge Pakistan to Improve Imran Khan's Prison Conditions
3. T20 World Cup: How to Watch Afghanistan vs. Canada in the US
Overall Sentiment: Neutral

Human Verification

• Verified scenarios: Agent starts, receives messages, searches web, returns structured summary
• Edge cases checked: Empty skills list, memory storage, local Ollama without API key
• What you did NOT verify: Postgres storage, Redis scheduler, multi-user concurrent requests

Compatibility / Migration

• Backward compatible? Yes
• Config/env changes? No
• Database migration needed? No

Failure Recovery

• How to revert: Delete examples/news-summarizer/ folder
• Known bad symptoms: If Ollama not running, agent starts but times out on requests

Risks and Mitigations

• Risk: DuckDuckGo rate limiting on heavy use
  • Mitigation: For production, replace with a paid news API

Checklist

• Pre-commit hooks pass
• Documentation updated
• Security impact assessed
• Human verification completed
• Backward compatibility confirmed

[raahulrahl]

LGTM