symbols: Add sub-repo filtering

Created by: ryanslade

Sub-repo filtering is now optionally checked in the only exported method of the symbols client, Search.

Closes https://github.com/sourcegraph/sourcegraph/issues/28273