TinyFishSearchTool

def __init__(
    self,
    *,
    llm_config: LLMConfig | dict[str, Any] | None = None,
    tinyfish_api_key: str | None = None,
):
    """Initializes the TinyFishSearchTool.

    Args:
        llm_config (Optional[Union[LLMConfig, dict[str, Any]]]): LLM configuration.
            (Currently unused but kept for potential future integration).
        tinyfish_api_key (Optional[str]): The API key for the TinyFish API. If not provided,
            it attempts to read from the ``TINYFISH_API_KEY`` environment variable.

    Raises:
        ValueError: If ``tinyfish_api_key`` is not provided either directly or via the environment variable.
    """
    self.tinyfish_api_key = tinyfish_api_key or os.getenv("TINYFISH_API_KEY")

    if self.tinyfish_api_key is None:
        raise ValueError("tinyfish_api_key must be provided either as an argument or via TINYFISH_API_KEY env var")

    def tinyfish_search(
        query: Annotated[str, "The search query string."],
        tinyfish_api_key: Annotated[str | None, Depends(on(self.tinyfish_api_key))],
        location: Annotated[str | None, "Optional country or location for geo-targeted results."] = None,
        language: Annotated[str | None, "Optional language code for result language."] = None,
    ) -> dict[str, Any]:
        """Search the web using TinyFish Search.

        Args:
            query: The search query string.
            tinyfish_api_key: The API key for TinyFish (injected dependency).
            location: Optional country or location for geo-targeted results.
            language: Optional language code for result language.

        Returns:
            A dictionary containing the query, total result count, and ranked results.

        Raises:
            ValueError: If the TinyFish API key is not available.
        """
        if tinyfish_api_key is None:
            raise ValueError("TinyFish API key is missing.")
        return _tinyfish_search(
            query=query,
            tinyfish_api_key=tinyfish_api_key,
            location=location,
            language=language,
        )

    super().__init__(
        name="tinyfish_search",
        description="Search the web using TinyFish. Returns ranked results with titles, snippets, site names, and URLs.",
        func_or_tool=tinyfish_search,
    )