Returns the most relevant tools for the given query, ranked by
    graph-based hybrid retrieval (BM25 + graph traversal + embedding).
    Previously called tools are automatically deprioritized to surface
    new candidates on repeated searches.

    Args:
        query: Natural language description of what you want to do.
               Examples: "user authentication", "delete a file",
               "manage shopping cart items"
        top_k: Maximum number of tools to return per page (default: 5)
        page: 1-based page for browsing beyond the first results. The
              response carries ``page`` and ``has_more`` so you can decide
              whether to request the next page.
    

    Use this after search_tools() to get complete parameter details
    for a tool you want to call.

    Args:
        name: Exact tool name (as returned by search_tools)
    

    Sends the actual HTTP request based on the tool's method and path
    from the OpenAPI spec. Use after search_tools() + get_tool_schema()
    to call the API.

    Args:
        tool_name: Exact tool name (as returned by search_tools)
        arguments: JSON string of parameter values (e.g. '{"owner":"me","repo":"test"}')
        base_url: API base URL (e.g. https://api.github.com). Required if not inferrable.
        auth_token: Bearer token for authentication (optional)
    

    Supports:
    - Direct spec URLs (JSON/YAML): https://api.example.com/openapi.json
    - Swagger UI URLs: https://api.example.com/swagger-ui/index.html
    - Local file paths: ./openapi.json, /path/to/spec.yaml

    Args:
        source: OpenAPI spec URL or local file path