Borsa MCP

"""
Economic calendar models for Yahoo Finance economic events.
Contains models for macroeconomic events, GDP data, inflation,
employment statistics, and market-moving economic indicators.
"""
from pydantic import BaseModel, Field
from typing import List, Optional
import datetime

# --- Yahoo Finance Economic Calendar Models ---

class EkonomikOlayDetayi(BaseModel):
    """Details of a single economic event."""
    event_name: Optional[str] = Field(None, description="Name of the economic event (e.g., 'GDP YY', 'Industrial Output YY').")
    country_code: Optional[str] = Field(None, description="Country code (e.g., 'US', 'GB', 'JP').")
    country_name: Optional[str] = Field(None, description="Full country name (e.g., 'United States', 'United Kingdom').")
    event_time: Optional[str] = Field(None, description="Event time in local timezone.")
    period: Optional[str] = Field(None, description="Period for the data (e.g., 'Nov', 'Q3', 'Dec').")
    
    # Economic data values
    actual: Optional[str] = Field(None, description="Actual reported value.")
    prior: Optional[str] = Field(None, description="Previous period value.")
    forecast: Optional[str] = Field(None, description="Forecasted value.")
    revised_from: Optional[str] = Field(None, description="Revised from previous estimate.")
    
    # Event metadata
    importance: Optional[str] = Field(None, description="Event importance level: 'high', 'medium', 'low'.")
    description: Optional[str] = Field(None, description="Detailed description of the economic indicator.")
    unit: Optional[str] = Field(None, description="Unit of measurement (%, YoY, QoQ, Index, etc.).")
    frequency: Optional[str] = Field(None, description="Data release frequency (Monthly, Quarterly, Annually).")

class EkonomikOlay(BaseModel):
    """Economic events for a single day."""
    date: Optional[str] = Field(None, description="Event date (YYYY-MM-DD format).")
    timezone: Optional[str] = Field(None, description="Timezone for the events (e.g., 'America/New_York').")
    event_count: Optional[int] = Field(None, description="Number of events on this date.")
    events: List[EkonomikOlayDetayi] = Field(default_factory=list, description="List of economic events for this date.")
    
    # Daily summary
    high_importance_count: Optional[int] = Field(None, description="Number of high importance events.")
    countries_involved: Optional[List[str]] = Field(None, description="List of countries with events.")
    event_types: Optional[List[str]] = Field(None, description="Types of economic events.")

class EkonomikTakvimSonucu(BaseModel):
    """Result of economic calendar query from Yahoo Finance."""
    start_date: Optional[str] = Field(None, description="Start date of the query period.")
    end_date: Optional[str] = Field(None, description="End date of the query period.")
    high_importance_only: Optional[bool] = Field(None, description="Whether only high importance events were requested.")
    country_filter: Optional[str] = Field(None, description="Country filter applied (e.g., 'US,GB,JP').")
    
    # Calendar data
    economic_events: List[EkonomikOlay] = Field(default_factory=list, description="Economic events grouped by date.")
    total_events: Optional[int] = Field(None, description="Total number of events across all dates.")
    total_days: Optional[int] = Field(None, description="Number of days with events.")
    
    # Summary statistics
    countries_covered: Optional[List[str]] = Field(None, description="All countries with events in the period.")
    event_categories: Optional[List[str]] = Field(None, description="Categories of economic events found.")
    high_impact_events: Optional[int] = Field(None, description="Number of high impact events.")
    
    # Market context
    major_releases: Optional[List[str]] = Field(None, description="Major economic releases in the period (GDP, Jobs, etc.).")
    market_moving_events: Optional[List[str]] = Field(None, description="Events likely to move markets significantly.")
    
    # Metadata
    query_timestamp: Optional[datetime.datetime] = Field(None, description="When the query was executed.")
    data_source: Optional[str] = Field(None, description="Data source.")
    api_endpoint: Optional[str] = Field(None, description="API endpoint used for the query.")
    
    error_message: Optional[str] = Field(None, description="Error message if query failed.")