initial

danistay_mcp_module/models.py

@@ -0,0 +1,116 @@
+# danistay_mcp_module/models.py
+
+from pydantic import BaseModel, Field, HttpUrl
+from typing import List, Optional, Dict, Any
+
+class DanistayBaseSearchRequest(BaseModel):
+    """Base model for common search parameters for Danistay."""
+    pageSize: int = Field(default=10, ge=1, le=100)
+    pageNumber: int = Field(default=1, ge=1)
+    # siralama and siralamaDirection are part of detailed search, not necessarily keyword search
+    # as per user's provided payloads.
+
+class DanistayKeywordSearchRequestData(BaseModel):
+    """Internal data model for the keyword search payload's 'data' field."""
+    andKelimeler: List[str] = Field(default_factory=list)
+    orKelimeler: List[str] = Field(default_factory=list)
+    notAndKelimeler: List[str] = Field(default_factory=list)
+    notOrKelimeler: List[str] = Field(default_factory=list)
+    pageSize: int
+    pageNumber: int
+
+class DanistayKeywordSearchRequest(BaseModel): # This is the model the MCP tool will accept
+    """Model for keyword-based search request for Danistay."""
+    andKelimeler: List[str] = Field(default_factory=list, description="Keywords for AND logic, e.g., ['word1', 'word2']")
+    orKelimeler: List[str] = Field(default_factory=list, description="Keywords for OR logic.")
+    notAndKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT AND logic.")
+    notOrKelimeler: List[str] = Field(default_factory=list, description="Keywords for NOT OR logic.")
+    pageSize: int = Field(default=10, ge=1, le=100)
+    pageNumber: int = Field(default=1, ge=1)
+
+class DanistayDetailedSearchRequestData(BaseModel): # Internal data model for detailed search payload
+    """Internal data model for the detailed search payload's 'data' field."""
+    daire: Optional[str] = "" # API expects empty string for None
+    esasYil: Optional[str] = ""
+    esasIlkSiraNo: Optional[str] = ""
+    esasSonSiraNo: Optional[str] = ""
+    kararYil: Optional[str] = ""
+    kararIlkSiraNo: Optional[str] = ""
+    kararSonSiraNo: Optional[str] = ""
+    baslangicTarihi: Optional[str] = ""
+    bitisTarihi: Optional[str] = ""
+    mevzuatNumarasi: Optional[str] = ""
+    mevzuatAdi: Optional[str] = ""
+    madde: Optional[str] = ""
+    siralama: str # Seems mandatory in detailed search payload
+    siralamaDirection: str # Seems mandatory
+    pageSize: int
+    pageNumber: int
+    # Note: 'arananKelime' is not in the detailed search payload example provided by user.
+    # If it can be included, it should be added here.
+
+class DanistayDetailedSearchRequest(DanistayBaseSearchRequest): # MCP tool will accept this
+    """Model for detailed search request for Danistay."""
+    daire: Optional[str] = Field(None, description="Chamber/Department name (e.g., '1. Daire').")
+    esasYil: Optional[str] = Field(None, description="Case year for 'Esas No'.")
+    esasIlkSiraNo: Optional[str] = Field(None, description="Starting sequence for 'Esas No'.")
+    esasSonSiraNo: Optional[str] = Field(None, description="Ending sequence for 'Esas No'.")
+    kararYil: Optional[str] = Field(None, description="Decision year for 'Karar No'.")
+    kararIlkSiraNo: Optional[str] = Field(None, description="Starting sequence for 'Karar No'.")
+    kararSonSiraNo: Optional[str] = Field(None, description="Ending sequence for 'Karar No'.")
+    baslangicTarihi: Optional[str] = Field(None, description="Start date for decision (DD.MM.YYYY).")
+    bitisTarihi: Optional[str] = Field(None, description="End date for decision (DD.MM.YYYY).")
+    mevzuatNumarasi: Optional[str] = Field(None, description="Legislation number.")
+    mevzuatAdi: Optional[str] = Field(None, description="Legislation name.")
+    madde: Optional[str] = Field(None, description="Article number.")
+    siralama: str = Field("1", description="Sorting criteria (e.g., 1: Esas No, 3: Karar Tarihi).")
+    siralamaDirection: str = Field("desc", description="Sorting direction ('asc' or 'desc').")
+    # Add a general keyword field if detailed search also supports it
+    # arananKelime: Optional[str] = Field(None, description="General keyword for detailed search.")
+
+
+class DanistayApiDecisionEntry(BaseModel):
+    """Model for an individual decision entry from the Danistay API search response.
+       Based on user-provided response samples for both keyword and detailed search.
+    """
+    id: str
+    # The API response for keyword search uses "daireKurul", detailed search example uses "daire".
+    # We use an alias to handle both and map to a consistent field name "chamber".
+    chamber: Optional[str] = Field(None, alias="daire", alt_alias="daireKurul", description="The chamber or board.")
+    esasNo: Optional[str] = Field(None)
+    kararNo: Optional[str] = Field(None)
+    kararTarihi: Optional[str] = Field(None)
+    arananKelime: Optional[str] = Field(None, description="Matched keyword if provided in response.")
+    # index: Optional[int] = None # Present in response, can be added if needed by MCP tool
+    # siraNo: Optional[int] = None # Present in detailed response, can be added
+
+    document_url: Optional[HttpUrl] = Field(None, description="URL to the full document, constructed by the client.")
+
+    class Config:
+        populate_by_name = True # Important for alias to work
+        extra = 'ignore' # Ignore any extra fields from API not defined in model
+
+class DanistayApiResponseInnerData(BaseModel):
+    """Model for the inner 'data' object in the Danistay API search response."""
+    data: List[DanistayApiDecisionEntry]
+    recordsTotal: int
+    recordsFiltered: int
+    draw: Optional[int] = Field(None, description="Draw counter from API, usually for DataTables.")
+
+class DanistayApiResponse(BaseModel):
+    """Model for the complete search response from the Danistay API."""
+    data: DanistayApiResponseInnerData
+    metadata: Optional[Dict[str, Any]] = Field(None, description="Optional metadata from API.")
+
+class DanistayDocumentMarkdown(BaseModel):
+    """Model for a Danistay decision document, containing only Markdown content."""
+    document_id: str
+    markdown_content: Optional[str] = Field(None, description="The decision content converted to Markdown.")
+    source_url: HttpUrl
+
+class CompactDanistaySearchResult(BaseModel):
+    """A compact search result model for the MCP tool to return."""
+    decisions: List[DanistayApiDecisionEntry]
+    total_records: int
+    requested_page: int
+    page_size: int