Changelog - November 29, 2025

🚀 New Features

New Agent: Created tradingagents/agents/screening_agent.py.
Purpose: Identifies potential stock candidates ("Hidden Gems") for further analysis by the main Trading Graph.
Strategy: Implemented an "Early Bird" multi-factor strategy:
- Social Hype: Detects stocks trending on StockTwits and Reddit.
- Insider Activity: Checks for recent buying by company executives.
- Technical Analysis: Identifies Oversold conditions (RSI < 30) or Divergence.
- Catalysts: Checks for upcoming earnings reports.

get_trending_social: New tool in tradingagents/dataflows/social_sentiment.py to fetch trending tickers from StockTwits and Ape Wisdom (Reddit).
get_market_movers: Added to tradingagents/dataflows/alpha_vantage_market.py to find Top Gainers/Losers.
get_earnings_calendar: Added to tradingagents/dataflows/alpha_vantage_market.py.
Integrated Tools: Exposed get_insider_transactions and get_indicators to the Screening Agent.

main_screening.py: Created a dedicated script to run the Screening Agent.
- Multi-Step Reasoning: Implemented a loop allowing the agent to chain tool calls (e.g., Screen -> Check Social -> Recommend) before outputting a final decision.

interface.py:
- Updated TOOLS_CATEGORIES and VENDOR_METHODS to support new tools.
- Fix: Resolved a critical SyntaxError caused by a corrupted edit.
agent_utils.py:
- Fix: Restored file integrity after it was corrupted during an edit.
- Added imports for all new screening tools.

.gitignore: Corrected to ensure tradingagents/ source code is tracked by Git (removed accidental exclusion).
Dependencies: Added python-dotenv to requirements.txt and setup.py.