LocalFS MCP Server

"""Search operation schemas."""

from typing import Optional
from pydantic import BaseModel, Field


class SearchMatch(BaseModel):
    """A single search match result."""

    path: str = Field(..., description="Relative path from root")
    name: str = Field(..., description="File or directory name")
    is_directory: bool = Field(..., description="True if directory, False if file")
    size_bytes: int = Field(..., description="Size in bytes")
    match_context: Optional[str] = Field(
        None, description="Context around match (for content searches)"
    )
    line_number: Optional[int] = Field(
        None, description="Line number of match (for content searches)"
    )


class SearchResult(BaseModel):
    """Result of a search operation."""

    matches: list[SearchMatch] = Field(..., description="List of matching items")
    total_matches: int = Field(..., description="Total number of matches found")
    search_depth_reached: int = Field(..., description="Maximum depth reached during search")
    truncated: bool = Field(False, description="True if results were limited")